eggsact 1.2.7

Deterministic MCP and in-process utility tools for coding agents
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
use serde_json::Value;

pub fn repo_manifest_inspect_input() -> Value {
    serde_json::json!({
        "type": "object",
        "properties": {
            "paths": {
                "type": "array",
                "items": {"type": "string"},
                "description": "List of relative file paths in the repository",
                "maxItems": 200
            },
            "file_summaries": {
                "type": "object",
                "description": "Optional map from path to small text sample or complete text for known manifests",
                "additionalProperties": {"type": "string"}
            },
            "workspace_root": {
                "type": "string",
                "description": "Optional workspace root for path-scope context"
            },
            "max_paths": {
                "type": "integer",
                "default": 200,
                "description": "Maximum number of paths to process"
            }
        },
        "required": ["paths"]
    })
}

pub fn repo_manifest_inspect_output() -> Value {
    serde_json::json!({
        "type": "object",
        "properties": {
            "project_types": {
                "type": "array",
                "items": {"type": "string"},
                "enum": ["rust", "python", "node", "go", "mixed", "unknown"],
                "description": "Detected project types"
            },
            "manifest_paths": {
                "type": "object",
                "description": "Detected manifest files by category",
                "properties": {
                    "rust": {"type": "array", "items": {"type": "string"}},
                    "python": {"type": "array", "items": {"type": "string"}},
                    "node": {"type": "array", "items": {"type": "string"}},
                    "go": {"type": "array", "items": {"type": "string"}},
                    "other": {"type": "array", "items": {"type": "string"}}
                }
            },
            "config_paths": {
                "type": "array",
                "items": {"type": "string"},
                "description": "Detected configuration file paths"
            },
            "lockfile_paths": {
                "type": "array",
                "items": {"type": "string"},
                "description": "Detected lockfile paths"
            },
            "tool_hints": {
                "type": "object",
                "description": "Suggested tools and commands for this repo type",
                "properties": {
                    "inspect_tools": {
                        "type": "array",
                        "items": {"type": "string"},
                        "description": "Recommended inspection tools (e.g. cargo_toml_inspect)"
                    },
                    "commands": {
                        "type": "array",
                        "items": {"type": "string"},
                        "description": "Recommended build/test commands"
                    }
                }
            },
            "verdict": {
                "type": "string",
                "enum": ["allow", "review", "block"],
                "description": "Whether repo structure is deterministically classifiable"
            },
            "findings": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Structured findings"
            }
        }
    })
}

pub fn config_file_inspect_input() -> Value {
    serde_json::json!({
        "type": "object",
        "properties": {
            "file_path": {
                "type": "string",
                "description": "Path to the config file"
            },
            "text": {
                "type": "string",
                "description": "Content of the config file"
            },
            "format": {
                "type": "string",
                "enum": ["auto", "json", "toml", "yaml", "dotenv", "ini", "cargo_toml", "package_json", "pyproject"],
                "default": "auto",
                "description": "Config file format. Auto-detect from file_path and content if not specified."
            },
            "policy": {
                "type": "object",
                "description": "Optional policy overrides for risk detection",
                "properties": {
                    "allow_debug_flags": {
                        "type": "boolean",
                        "default": false,
                        "description": "Allow debug flags without review"
                    },
                    "allow_insecure_urls": {
                        "type": "boolean",
                        "default": false,
                        "description": "Allow http:// URLs without review"
                    },
                    "allow_command_hooks": {
                        "type": "boolean",
                        "default": false,
                        "description": "Allow command hooks without review"
                    }
                }
            }
        },
        "required": ["file_path", "text"]
    })
}

pub fn config_file_inspect_output() -> Value {
    serde_json::json!({
        "type": "object",
        "properties": {
            "file_path": {
                "type": "string",
                "description": "The config file path"
            },
            "format": {
                "type": "string",
                "description": "Detected or specified format"
            },
            "parse_ok": {
                "type": "boolean",
                "description": "Whether the config file parsed successfully. Parser-backed for JSON/TOML family formats; for YAML (and dotenv/INI/unknown) this only reports that heuristic scanning completed — YAML syntax is NOT validated (see analysis_mode)."
            },
            "analysis_mode": {
                "type": "string",
                "enum": ["parser", "heuristic"],
                "description": "How parse_ok was produced: \"parser\" means a real parser verdict (JSON/TOML family); \"heuristic\" means a line-oriented scan with no syntax validation (YAML, dotenv, INI, unknown). YAML key extraction is a naive `key: value` line scan; malformed YAML still reports parse_ok true when non-empty."
            },
            "shape_summary": {
                "type": "object",
                "description": "High-level shape summary of the config"
            },
            "risky_keys": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Keys that pose security or operational risk"
            },
            "secret_risks": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Secret-like key/value pairs detected"
            },
            "insecure_urls": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Insecure URLs (http:// where https:// expected)"
            },
            "debug_flags": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Debug flags that may be risky in production"
            },
            "command_hooks": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Executable hook fields detected"
            },
            "verdict": {
                "type": "string",
                "enum": ["allow", "review", "block"],
                "description": "Whether config requires review"
            },
            "machine_code": {
                "type": "string",
                "description": "Machine-readable response code"
            },
            "findings": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Structured findings with severity and disposition"
            }
        }
    })
}

pub fn test_command_suggest_input() -> Value {
    serde_json::json!({
        "type": "object",
        "properties": {
            "paths": {
                "type": "array",
                "items": {"type": "string"},
                "description": "Repository-relative file paths"
            },
            "manifest_snippets": {
                "type": "object",
                "description": "Optional map from manifest path to its content snippet",
                "additionalProperties": {"type": "string"}
            },
            "detail": {
                "type": "string",
                "enum": ["summary", "normal", "full"],
                "default": "normal",
                "description": "Detail level for output"
            }
        },
        "required": ["paths"]
    })
}

pub fn test_command_suggest_output() -> Value {
    serde_json::json!({
        "type": "object",
        "properties": {
            "project_types": {
                "type": "array",
                "items": {"type": "string"},
                "description": "Detected project types"
            },
            "suggested_commands": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Suggested verification commands with category and confidence",
                "properties": {
                    "command": {"type": "string"},
                    "category": {"type": "string", "enum": ["build", "test", "lint", "format", "typecheck", "other"]},
                    "confidence": {"type": "number", "description": "Confidence score 0.0-1.0"},
                    "reason": {"type": "string"}
                }
            },
            "verdict": {
                "type": "string",
                "enum": ["allow", "review", "block"],
                "description": "Whether suggestions are deterministically derivable"
            },
            "machine_code": {"type": "string", "description": "Machine-readable response code"},
            "findings": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Structured findings"
            }
        }
    })
}

pub fn repo_language_detect_input() -> Value {
    serde_json::json!({
        "type": "object",
        "properties": {
            "paths": {
                "type": "array",
                "items": {"type": "string"},
                "description": "Repository-relative file paths to analyze"
            },
            "manifest_snippets": {
                "type": "object",
                "description": "Optional map from manifest path to its content snippet",
                "additionalProperties": {"type": "string"}
            },
            "max_paths": {
                "type": "integer",
                "default": 500,
                "description": "Maximum number of paths to process"
            }
        },
        "required": ["paths"]
    })
}

pub fn repo_language_detect_output() -> Value {
    serde_json::json!({
        "type": "object",
        "properties": {
            "languages": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Detected languages with file counts and confidence",
                "properties": {
                    "name": {"type": "string"},
                    "file_count": {"type": "integer"},
                    "extensions": {"type": "array", "items": {"type": "string"}},
                    "confidence": {"type": "number", "description": "Confidence score 0.0-1.0"}
                }
            },
            "ecosystems": {
                "type": "array",
                "items": {"type": "string"},
                "description": "Detected ecosystems (rust, python, node, go, etc.)"
            },
            "primary_language": {
                "type": ["string", "null"],
                "description": "Dominant language by file count"
            },
            "verdict": {
                "type": "string",
                "enum": ["allow", "review", "block"],
                "description": "Whether detection is deterministically derivable"
            },
            "machine_code": {"type": "string", "description": "Machine-readable response code"},
            "findings": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Structured findings"
            }
        }
    })
}

pub fn repo_tree_summarize_input() -> Value {
    serde_json::json!({
        "type": "object",
        "properties": {
            "paths": {
                "type": "array",
                "items": {"type": "string"},
                "description": "Repository-relative paths to summarize"
            },
            "file_sizes": {
                "type": "object",
                "additionalProperties": {"type": "integer"},
                "description": "Optional byte sizes keyed by path"
            },
            "statuses": {
                "type": "object",
                "additionalProperties": {"type": "string"},
                "description": "Optional git-like status keyed by path"
            },
            "max_paths": {
                "type": "integer",
                "default": 1000,
                "description": "Maximum number of paths to process"
            },
            "detail": {
                "type": "string",
                "enum": ["summary", "normal", "full"],
                "default": "normal",
                "description": "Detail level for output"
            }
        },
        "required": ["paths"]
    })
}

pub fn repo_tree_summarize_output() -> Value {
    serde_json::json!({
        "type": "object",
        "properties": {
            "project_types": {
                "type": "array",
                "items": {"type": "string"},
                "description": "Detected project types"
            },
            "path_count": {"type": "integer", "description": "Total number of paths processed"},
            "directory_count": {"type": "integer", "description": "Number of directory-like paths"},
            "file_count": {"type": "integer", "description": "Number of file-like paths"},
            "buckets": {
                "type": "object",
                "description": "Paths grouped by classification bucket",
                "additionalProperties": {"type": "array", "items": {"type": "string"}}
            },
            "entrypoint_candidates": {
                "type": "array",
                "items": {"type": "string"},
                "description": "Likely entry files"
            },
            "high_leverage_paths": {
                "type": "array",
                "items": {"type": "string"},
                "description": "CI, dependency, security, and build paths"
            },
            "tool_hints": {
                "type": "array",
                "items": {"type": "string"},
                "description": "Recommended eggsact tools for this repo"
            },
            "verdict": {
                "type": "string",
                "enum": ["allow", "review", "block"],
                "description": "Whether repo structure is deterministically classifiable"
            },
            "machine_code": {
                "type": "string",
                "description": "Machine-readable response code"
            },
            "findings": {
                "type": "array",
                "items": {"type": "object"},
                "description": "Structured findings"
            }
        }
    })
}