Interface ForgeResult

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.

interface ForgeResult {
    success: boolean;
    toolId?: string;
    tool?: EmergentTool;
    verdict?: CreationVerdict;
    error?: string;
}

Properties

success: boolean

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

toolId?: string

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

Example

"emergent:a1b2c3d4-e5f6-..."

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

verdict?: CreationVerdict

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

error?: string

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