Interface: ForgeToolRequest
Defined in: packages/agentos/src/cognition/emergent/types.ts:834
Request payload for the forge_tool system tool.
An agent submits this to request the creation of a new emergent tool. The engine validates the request, runs the judge, and returns a ForgeResult.
Properties
description
description:
string
Defined in: packages/agentos/src/cognition/emergent/types.ts:845
Natural language description of the tool's purpose and behaviour. Used verbatim as the tool's description in the LLM tool list.
implementation
implementation:
ToolImplementation
Defined in: packages/agentos/src/cognition/emergent/types.ts:860
Implementation specification — composable pipeline or sandboxed code.
inputSchema
inputSchema:
JSONSchemaObject
Defined in: packages/agentos/src/cognition/emergent/types.ts:850
JSON Schema for the tool's input arguments.
justification?
optionaljustification:unknown
Defined in: packages/agentos/src/cognition/emergent/types.ts:875
Optional: the forging agent's own statement of the gap the tool fills, a
string when the agent follows the description in forge_tool's input
schema. Any JSON value is accepted. The forge's trace records it: a string
as given, cut to its cap; any other value as its JSON-safe text; a cut one
with its path in the trace's sizes.cut. The judge does not read it.
name
name:
string
Defined in: packages/agentos/src/cognition/emergent/types.ts:839
Desired machine-readable name for the new tool. Must be unique among tools currently visible to the requesting agent.
outputSchema
outputSchema:
JSONSchemaObject
Defined in: packages/agentos/src/cognition/emergent/types.ts:855
JSON Schema for the tool's expected output.
testCases
testCases: [
ForgeTestCase,...ForgeTestCase[]]
Defined in: packages/agentos/src/cognition/emergent/types.ts:866
One or more test cases the judge uses to evaluate correctness. At least one test case is required for the forge request to be accepted.