Skip to main content

Interface: ForgeResult

Defined in: packages/agentos/src/emergent/types.ts:574

Result returned after a forge_tool invocation.

On success the new tool is registered and available immediately. On failure the verdict field explains why the judge rejected the tool.

Properties

error?

optional error: string

Defined in: packages/agentos/src/emergent/types.ts:602

Human-readable error message for system-level failures (e.g., sandbox crash, schema parse error). Distinct from judge rejection — check verdict for those.


success

success: boolean

Defined in: packages/agentos/src/emergent/types.ts:578

true when the tool was forged, judged, and registered successfully.


tool?

optional tool: EmergentTool

Defined in: packages/agentos/src/emergent/types.ts:589

The full emergent tool record, present only when success is true.


toolId?

optional toolId: string

Defined in: packages/agentos/src/emergent/types.ts:584

The assigned tool ID, present only when success is true.

Example

"emergent:a1b2c3d4-e5f6-..."

verdict?

optional verdict: CreationVerdict

Defined in: packages/agentos/src/emergent/types.ts:596

The judge's creation verdict. Present whether the forge succeeded or was rejected — callers can inspect verdict.reasoning to understand why a rejection occurred.