@studio-foundation/contracts 0.3.0-beta.1 → 0.3.0-beta.6

package/dist/agent.d.ts

@@ -0,0 +1,28 @@
+export interface AgentConfig {
+    name: string;
+    description?: string;
+    provider?: string;
+    model?: string;
+    system_prompt?: string;
+    tools?: string[];
+    plugins?: string[];
+    skills?: string[];
+    temperature?: number;
+    max_tokens?: number;
+    anonymize?: boolean;
+}
+/** AgentConfig after defaults have been applied — provider and model are guaranteed. */
+export interface ResolvedAgentConfig extends AgentConfig {
+    provider: string;
+    model: string;
+}
+export interface AgentProfile extends AgentConfig {
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+    result?: unknown;
+    error?: string;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wFAAwF;AACxF,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;CAEhD;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/agent.js

@@ -0,0 +1,3 @@
+// Agent configuration and profiles
+export {};
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,mCAAmC"}

package/dist/context-pack.d.ts

@@ -0,0 +1,21 @@
+export interface ContextPackDefinition {
+    name: string;
+    description?: string;
+    version: number;
+    files?: Array<{
+        path: string;
+    }>;
+    inline?: Array<{
+        title: string;
+        content: string;
+    }>;
+}
+export interface ResolvedContextPack {
+    name: string;
+    description?: string;
+    sections: Array<{
+        title: string;
+        content: string;
+    }>;
+}
+//# sourceMappingURL=context-pack.d.ts.map

package/dist/context-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack.d.ts","sourceRoot":"","sources":["../src/context-pack.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD"}

package/dist/context-pack.js

@@ -0,0 +1,3 @@
+// Shared types for the context packs feature (STU-13)
+export {};
+//# sourceMappingURL=context-pack.js.map

package/dist/context-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack.js","sourceRoot":"","sources":["../src/context-pack.ts"],"names":[],"mappings":"AAAA,sDAAsD"}

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+export declare enum ErrorCode {
+    VALIDATION_FAILED = "VALIDATION_FAILED",
+    AGENT_EXECUTION_FAILED = "AGENT_EXECUTION_FAILED",
+    STAGE_FAILED = "STAGE_FAILED",
+    PIPELINE_FAILED = "PIPELINE_FAILED",
+    RALPH_EXHAUSTED = "RALPH_EXHAUSTED",
+    TOOL_EXECUTION_FAILED = "TOOL_EXECUTION_FAILED",
+    PROVIDER_ERROR = "PROVIDER_ERROR",
+    CONFIGURATION_ERROR = "CONFIGURATION_ERROR"
+}
+export declare class StudioError extends Error {
+    code: ErrorCode;
+    details?: Record<string, unknown> | undefined;
+    constructor(code: ErrorCode, message: string, details?: Record<string, unknown> | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,oBAAY,SAAS;IACnB,iBAAiB,sBAAsB;IACvC,sBAAsB,2BAA2B;IACjD,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,qBAAqB,0BAA0B;IAC/C,cAAc,mBAAmB;IACjC,mBAAmB,wBAAwB;CAC5C;AAED,qBAAa,WAAY,SAAQ,KAAK;IAE3B,IAAI,EAAE,SAAS;IAEf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAK3C"}

package/dist/errors.js

@@ -0,0 +1,23 @@
+// Error types and codes
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    ErrorCode["AGENT_EXECUTION_FAILED"] = "AGENT_EXECUTION_FAILED";
+    ErrorCode["STAGE_FAILED"] = "STAGE_FAILED";
+    ErrorCode["PIPELINE_FAILED"] = "PIPELINE_FAILED";
+    ErrorCode["RALPH_EXHAUSTED"] = "RALPH_EXHAUSTED";
+    ErrorCode["TOOL_EXECUTION_FAILED"] = "TOOL_EXECUTION_FAILED";
+    ErrorCode["PROVIDER_ERROR"] = "PROVIDER_ERROR";
+    ErrorCode["CONFIGURATION_ERROR"] = "CONFIGURATION_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+export class StudioError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'StudioError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAExB,MAAM,CAAN,IAAY,SASX;AATD,WAAY,SAAS;IACnB,oDAAuC,CAAA;IACvC,8DAAiD,CAAA;IACjD,0CAA6B,CAAA;IAC7B,gDAAmC,CAAA;IACnC,gDAAmC,CAAA;IACnC,4DAA+C,CAAA;IAC/C,8CAAiC,CAAA;IACjC,wDAA2C,CAAA;AAC7C,CAAC,EATW,SAAS,KAAT,SAAS,QASpB;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IAE3B;IAEA;IAHT,YACS,IAAe,EACtB,OAAe,EACR,OAAiC;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAW;QAEf,YAAO,GAAP,OAAO,CAA0B;QAGxC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from './pipeline.js';
+export * from './stage.js';
+export * from './task.js';
+export * from './agent.js';
+export * from './run.js';
+export * from './validation.js';
+export * from './provider.js';
+export * from './errors.js';
+export * from './context-pack.js';
+export * from './tool-plugin.js';
+export * from './runner-events.js';
+export * from './spawner.js';
+export * from './integration-plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}

package/{src/index.ts → dist/index.js}

@@ -1,6 +1,5 @@
 // Export barrel for @studio/contracts
 // All types are re-exported from their source files
-
 export * from './pipeline.js';
 export * from './stage.js';
 export * from './task.js';
@@ -11,8 +10,7 @@ export * from './provider.js';
 export * from './errors.js';
 export * from './context-pack.js';
 export * from './tool-plugin.js';
-
 export * from './runner-events.js';
-
 export * from './spawner.js';
 export * from './integration-plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AAEpD,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}

package/dist/integration-plugin.d.ts

@@ -0,0 +1,35 @@
+export interface IntegrationPluginDef {
+    name: string;
+    version: number;
+    description?: string;
+    config?: {
+        required?: string[];
+        optional?: Record<string, unknown>;
+    };
+    events?: {
+        consumes?: string[];
+        emits?: string[];
+    };
+    test?: {
+        type: 'http';
+        endpoint: string;
+        method?: 'GET' | 'POST';
+        /** e.g. "bearer:${LINEAR_API_KEY}" — resolved before use */
+        auth?: string;
+        body?: string;
+        expect?: {
+            status?: number;
+        };
+    };
+    webhook?: {
+        hmac?: {
+            header: string;
+            secret_env: string;
+        };
+        handler: string;
+    };
+    on_failure?: {
+        handler: string;
+    };
+}
+//# sourceMappingURL=integration-plugin.d.ts.map

package/dist/integration-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-plugin.d.ts","sourceRoot":"","sources":["../src/integration-plugin.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IACF,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;QACxB,4DAA4D;QAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC9B,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE;YACL,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}

package/dist/integration-plugin.js

@@ -0,0 +1,3 @@
+// contracts/src/integration-plugin.ts
+export {};
+//# sourceMappingURL=integration-plugin.js.map

package/dist/integration-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-plugin.js","sourceRoot":"","sources":["../src/integration-plugin.ts"],"names":[],"mappings":"AAAA,sCAAsC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,79 @@
+import type { StageKind } from './stage';
+export interface InputField {
+    name: string;
+    type: 'text' | 'array';
+    prompt: string;
+    required: boolean;
+    default?: string;
+    items?: 'text';
+}
+export interface InputSchema {
+    type: 'structured';
+    fields: InputField[];
+}
+export interface StartupCommand {
+    command: string;
+    inject_as: string;
+}
+export interface PipelineDefinition {
+    name: string;
+    description: string;
+    version: number;
+    on_pipeline_start?: StartupCommand[];
+    input_schema?: InputSchema;
+    repo?: {
+        url: string;
+        branch?: string;
+    };
+    stages: PipelineEntry[];
+}
+export type HookOnFailure = 'warn' | 'reject' | 'fail';
+export interface StageHookDef {
+    command: string;
+    on_failure?: HookOnFailure;
+}
+export interface ToolHookDef {
+    matcher: string;
+    command: string;
+    on_failure?: 'warn' | 'reject';
+}
+export interface StageHooks {
+    on_stage_start?: StageHookDef[];
+    on_stage_complete?: StageHookDef[];
+    pre_tool_use?: ToolHookDef[];
+    post_tool_use?: ToolHookDef[];
+}
+export interface StageDefinition {
+    name: string;
+    condition?: string;
+    kind?: StageKind;
+    agent?: string;
+    executor?: 'script';
+    script?: string;
+    runtime?: 'python' | 'node' | 'shell';
+    timeout_ms?: number;
+    contract?: string;
+    ralph?: {
+        max_attempts: number;
+        retry_strategy: string;
+        max_tool_calls?: number;
+    };
+    context?: {
+        include: string[];
+        packs?: string[];
+    };
+    tools?: {
+        required?: string[];
+    };
+    hooks?: StageHooks;
+}
+export type PipelineEntry = StageDefinition | StageGroup;
+export interface StageGroup {
+    group: string;
+    max_iterations: number;
+    mode?: 'sequential' | 'parallel';
+    on_failure?: 'fail-fast' | 'collect-all';
+    stages: StageDefinition[];
+}
+export declare function isStageGroup(entry: PipelineEntry): entry is StageGroup;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/pipeline.js

@@ -0,0 +1,5 @@
+// Pipeline and Stage definitions
+export function isStageGroup(entry) {
+    return 'group' in entry && 'stages' in entry;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,iCAAiC;AA8FjC,MAAM,UAAU,YAAY,CAAC,KAAoB;IAC/C,OAAO,OAAO,IAAI,KAAK,IAAI,QAAQ,IAAI,KAAK,CAAC;AAC/C,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,35 @@
+export interface LLMRequest {
+    model: string;
+    messages: Message[];
+    tools?: ToolDefinition[];
+    temperature?: number;
+    max_tokens?: number;
+    stage_name?: string;
+    json_mode?: boolean;
+}
+export interface Message {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface LLMResponse {
+    content: string;
+    tool_calls?: Array<{
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+    finish_reason: string;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+        cached_input_tokens?: number;
+        cache_creation_tokens?: number;
+    };
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC"}

package/dist/provider.js

@@ -0,0 +1,3 @@
+// LLM provider interfaces
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,0BAA0B"}

package/dist/run.d.ts

@@ -0,0 +1,43 @@
+import type { StageStatus } from './stage';
+import type { TaskStatus } from './task';
+export type AgentStatus = 'pending' | 'running' | 'success' | 'failed';
+export interface PipelineRun {
+    id: string;
+    pipeline_name: string;
+    status: StageStatus;
+    started_at: string;
+    completed_at?: string;
+    stages: StageRun[];
+    input?: Record<string, unknown>;
+    parent_run_id?: string;
+}
+export interface StageRun {
+    id: string;
+    stage_name: string;
+    status: StageStatus;
+    started_at: string;
+    completed_at?: string;
+    tasks: TaskRun[];
+    output?: unknown;
+    skipped_reason?: string;
+}
+export interface TaskRun {
+    id: string;
+    task_name: string;
+    status: TaskStatus;
+    started_at: string;
+    completed_at?: string;
+    agent_runs: AgentRun[];
+}
+export interface AgentRun {
+    id: string;
+    agent_name: string;
+    attempt: number;
+    status: AgentStatus;
+    tool_calls: number;
+    started_at: string;
+    completed_at?: string;
+    output?: unknown;
+    error?: string;
+}
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/run.js

@@ -0,0 +1,3 @@
+// Runtime execution tracking
+export {};
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,6BAA6B"}

package/dist/runner-events.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Event types for real-time tool call streaming.
+ * Defined in contracts (leaf package) so runner can import them
+ * without creating an inverse dependency on engine.
+ */
+export interface ToolCallStartEvent {
+    tool: string;
+    params: Record<string, unknown>;
+    timestamp: number;
+}
+export interface ToolCallCompleteEvent {
+    tool: string;
+    result: unknown;
+    error?: string;
+    duration_ms: number;
+    timestamp: number;
+}
+export interface AgentThinkingEvent {
+    thought: string;
+    timestamp: number;
+}
+export interface AgentProgressEvent {
+    message: string;
+    timestamp: number;
+}
+export interface AgentTokenEvent {
+    token: string;
+    timestamp: number;
+}
+/**
+ * Subset of callbacks the runner accepts for real-time event emission.
+ * Engine populates these from EngineEvents and passes them to runAgent().
+ */
+export interface RunnerCallbacks {
+    onToolCallStart?: (event: ToolCallStartEvent) => void;
+    onToolCallComplete?: (event: ToolCallCompleteEvent) => void;
+    onAgentThinking?: (event: AgentThinkingEvent) => void;
+    onAgentProgress?: (event: AgentProgressEvent) => void;
+    onAgentToken?: (event: AgentTokenEvent) => void;
+    /**
+     * Called before tool execution. Return { blocked: true, error } to prevent the tool from running.
+     * The error is surfaced as the tool result so the LLM can react and RALPH loop continues.
+     */
+    onPreToolUse?: (event: {
+        tool: string;
+        params: Record<string, unknown>;
+        timestamp: number;
+    }) => Promise<{
+        blocked: boolean;
+        error?: string;
+    }>;
+    /**
+     * Called after tool execution (only if the tool was not blocked).
+     * Return { append_message } to inject a note into the conversation after the tool result.
+     * Only effective in the standard (Chat Completions) provider path.
+     */
+    onPostToolUse?: (event: {
+        tool: string;
+        params: Record<string, unknown>;
+        result: unknown;
+        error?: string;
+        timestamp: number;
+    }) => Promise<{
+        append_message?: string;
+    }>;
+}
+//# sourceMappingURL=runner-events.d.ts.map

package/dist/runner-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-events.d.ts","sourceRoot":"","sources":["../src/runner-events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACtD,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC5D,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACtD,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACtD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAEhD;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC;KACnB,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEpD;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,KAAK,OAAO,CAAC;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5C"}

package/dist/runner-events.js

@@ -0,0 +1,7 @@
+/**
+ * Event types for real-time tool call streaming.
+ * Defined in contracts (leaf package) so runner can import them
+ * without creating an inverse dependency on engine.
+ */
+export {};
+//# sourceMappingURL=runner-events.js.map

package/dist/runner-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-events.js","sourceRoot":"","sources":["../src/runner-events.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/spawner.d.ts

@@ -0,0 +1,15 @@
+export interface SpawnConfig {
+    pipeline: string;
+    input: Record<string, unknown>;
+    parentRunId: string;
+    depth: number;
+}
+export interface SpawnResult {
+    run_id: string;
+    status: string;
+    output: unknown;
+}
+export interface RunSpawner {
+    spawnAndWait(config: SpawnConfig): Promise<SpawnResult>;
+}
+//# sourceMappingURL=spawner.d.ts.map

package/dist/spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawner.d.ts","sourceRoot":"","sources":["../src/spawner.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACzD"}

package/dist/spawner.js

@@ -0,0 +1,4 @@
+// The abstraction that studio-run tool uses to launch child runs.
+// Implementations: DirectEngineSpawner (engine) and HttpApiSpawner (api).
+export {};
+//# sourceMappingURL=spawner.js.map

package/dist/spawner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawner.js","sourceRoot":"","sources":["../src/spawner.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,0EAA0E"}

package/{src/stage.ts → dist/stage.d.ts}

@@ -1,13 +1,10 @@
-// Stage status and results
-
 export type StageStatus = 'pending' | 'running' | 'success' | 'failed' | 'skipped' | 'rejected' | 'cancelled';
-
 export type StageKind = string;
-
 export interface StageResult {
-  status: StageStatus;
-  output?: unknown;
-  error?: string;
-  attempts: number;
-  duration_ms: number;
+    status: StageStatus;
+    output?: unknown;
+    error?: string;
+    attempts: number;
+    duration_ms: number;
 }
+//# sourceMappingURL=stage.d.ts.map

package/dist/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../src/stage.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAE9G,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/stage.js

@@ -0,0 +1,3 @@
+// Stage status and results
+export {};
+//# sourceMappingURL=stage.js.map

package/dist/stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.js","sourceRoot":"","sources":["../src/stage.ts"],"names":[],"mappings":"AAAA,2BAA2B"}

package/{src/task.ts → dist/task.d.ts}

@@ -1,3 +1,2 @@
-// Task status — used internally by run.ts (TaskRun.status)
-
 export type TaskStatus = 'pending' | 'running' | 'success' | 'failed';
+//# sourceMappingURL=task.d.ts.map

package/dist/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC"}

package/dist/task.js

@@ -0,0 +1,3 @@
+// Task status — used internally by run.ts (TaskRun.status)
+export {};
+//# sourceMappingURL=task.js.map

package/dist/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAAA,2DAA2D"}

package/dist/tool-plugin.d.ts

@@ -0,0 +1,42 @@
+export type ParseOutputFormat = 'text' | 'json';
+export interface ParameterDef {
+    type: 'string' | 'number' | 'boolean' | 'array';
+    description?: string;
+    required?: boolean;
+    default?: unknown;
+    items?: {
+        type: string;
+    };
+}
+export interface ShellExecute {
+    type: 'shell';
+    command: string;
+    parse_output?: ParseOutputFormat;
+    timeout_ms?: number;
+}
+export interface BuiltinExecute {
+    type: 'builtin';
+    handler?: string;
+    parse_output?: ParseOutputFormat;
+}
+export type CommandExecute = ShellExecute | BuiltinExecute;
+export interface ToolCommandDef {
+    name: string;
+    description: string;
+    parameters: Record<string, ParameterDef>;
+    execute: CommandExecute;
+    constraints?: Record<string, unknown>;
+}
+export interface ToolPluginDef {
+    name: string;
+    description?: string;
+    version: number;
+    commands: ToolCommandDef[];
+    config?: Record<string, unknown>;
+    prompt_snippet?: string;
+    constraints?: {
+        requires_initialized_repo?: boolean;
+        requires_binaries?: string[];
+    };
+}
+//# sourceMappingURL=tool-plugin.d.ts.map

package/dist/tool-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-plugin.d.ts","sourceRoot":"","sources":["../src/tool-plugin.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,cAAc,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE;QACZ,yBAAyB,CAAC,EAAE,OAAO,CAAC;QACpC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACH"}

package/dist/tool-plugin.js

@@ -0,0 +1,3 @@
+// contracts/src/tool-plugin.ts
+export {};
+//# sourceMappingURL=tool-plugin.js.map