@qodo/sdk 0.6.0 → 0.8.0

package/dist/sdk/artifacts.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Artifact Management for pipeline intermediate results.
+ *
+ * Each pipeline step can produce typed artifacts that are stored,
+ * serialized, and optionally persisted via user-supplied hooks.
+ *
+ * Usage:
+ *
+ *   import { ArtifactStore } from '@qodo/sdk';
+ *
+ *   const store = new ArtifactStore({
+ *     onPersist: async (artifact) => {
+ *       await fs.writeFile(`/artifacts/${artifact.stepName}.json`, artifact.serialized);
+ *     },
+ *   });
+ *
+ *   // In a pipeline step:
+ *   store.set('lint', { issues: 3, output: '...' });
+ *
+ *   // Retrieve later:
+ *   const lintResult = store.get('lint');
+ */
+/**
+ * A stored artifact with metadata.
+ */
+export interface Artifact<T = unknown> {
+    /** Step name that produced this artifact. */
+    stepName: string;
+    /** The artifact data. */
+    data: T;
+    /** ISO timestamp when the artifact was stored. */
+    createdAt: string;
+    /** Serialized representation (JSON by default). */
+    serialized: string;
+    /** Content type of the serialized representation. */
+    contentType: string;
+}
+/**
+ * Custom serializer for artifact data.
+ */
+export interface ArtifactSerializer {
+    /** Serialize the artifact data to a string. */
+    serialize(data: unknown): string;
+    /** Deserialize a string back to data. */
+    deserialize(serialized: string): unknown;
+    /** Content type identifier (e.g., 'application/json'). */
+    contentType: string;
+}
+/**
+ * Persistence hook called when an artifact is stored.
+ */
+export type PersistHook = (artifact: Artifact) => Promise<void> | void;
+/**
+ * Options for ArtifactStore.
+ */
+export interface ArtifactStoreOptions {
+    /**
+     * Called when an artifact is stored. Use for writing to disk,
+     * uploading to cloud storage, etc.
+     */
+    onPersist?: PersistHook;
+    /**
+     * Custom serializer (default: JSON with 2-space indent).
+     */
+    serializer?: ArtifactSerializer;
+}
+export declare const jsonSerializer: ArtifactSerializer;
+/**
+ * In-memory artifact store with optional persistence.
+ *
+ * Stores typed artifacts keyed by step name. When a persistence
+ * hook is provided, it is called asynchronously after each store
+ * operation (errors in the hook are caught and available via
+ * `getErrors()`).
+ */
+export declare class ArtifactStore {
+    private static readonly MAX_ERRORS;
+    private readonly artifacts;
+    private readonly serializer;
+    private readonly persistHook?;
+    private readonly errors;
+    constructor(options?: ArtifactStoreOptions);
+    /**
+     * Store an artifact for a given step name.
+     *
+     * Overwrites any existing artifact for the same step name.
+     * If a persistence hook is configured, it is called after storage.
+     */
+    set<T>(stepName: string, data: T): Promise<Artifact<T>>;
+    /**
+     * Retrieve an artifact by step name.
+     *
+     * Returns undefined if no artifact exists for the given step.
+     */
+    get<T = unknown>(stepName: string): Artifact<T> | undefined;
+    /**
+     * Check if an artifact exists for a given step name.
+     */
+    has(stepName: string): boolean;
+    /**
+     * Get all stored artifacts as an ordered array (insertion order).
+     */
+    all(): Artifact[];
+    /**
+     * Get all step names that have artifacts.
+     */
+    stepNames(): string[];
+    /**
+     * Delete an artifact by step name.
+     */
+    delete(stepName: string): boolean;
+    /**
+     * Clear all stored artifacts.
+     */
+    clear(): void;
+    /**
+     * Get persistence errors that occurred during set() calls.
+     */
+    getErrors(): ReadonlyArray<{
+        stepName: string;
+        error: Error;
+    }>;
+    /**
+     * Get the number of stored artifacts.
+     */
+    get size(): number;
+    /**
+     * Deserialize a previously serialized artifact back to data.
+     */
+    deserialize<T = unknown>(serialized: string): T;
+}
+/**
+ * Create a pipeline step wrapper that automatically stores the step's
+ * output as an artifact.
+ *
+ * Usage with sdkPipeline:
+ *
+ *   const store = new ArtifactStore({ onPersist: ... });
+ *
+ *   const pipeline = sdkPipeline<{ repo: string }>()
+ *     .step('lint', withArtifacts(store, async ({ state, run }) => {
+ *       const result = await run('lint', { args: { path: state.repo } });
+ *       return { lintOutput: result.result.final_output };
+ *     }))
+ *     .build();
+ */
+export declare function withArtifacts<TState extends Record<string, any>, TOut extends Record<string, any>>(store: ArtifactStore, fn: (ctx: {
+    state: Readonly<TState>;
+    run: any;
+    stepName: string;
+}) => Promise<TOut>): (ctx: {
+    state: Readonly<TState>;
+    run: any;
+    stepName: string;
+}) => Promise<TOut>;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/sdk/artifacts.d.ts.map

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

package/dist/sdk/artifacts.js

@@ -0,0 +1,166 @@
+/**
+ * Artifact Management for pipeline intermediate results.
+ *
+ * Each pipeline step can produce typed artifacts that are stored,
+ * serialized, and optionally persisted via user-supplied hooks.
+ *
+ * Usage:
+ *
+ *   import { ArtifactStore } from '@qodo/sdk';
+ *
+ *   const store = new ArtifactStore({
+ *     onPersist: async (artifact) => {
+ *       await fs.writeFile(`/artifacts/${artifact.stepName}.json`, artifact.serialized);
+ *     },
+ *   });
+ *
+ *   // In a pipeline step:
+ *   store.set('lint', { issues: 3, output: '...' });
+ *
+ *   // Retrieve later:
+ *   const lintResult = store.get('lint');
+ */
+// ---------------------------------------------------------------------------
+// Default JSON serializer
+// ---------------------------------------------------------------------------
+export const jsonSerializer = {
+    serialize: (data) => JSON.stringify(data, null, 2),
+    deserialize: (serialized) => JSON.parse(serialized),
+    contentType: 'application/json',
+};
+// ---------------------------------------------------------------------------
+// ArtifactStore
+// ---------------------------------------------------------------------------
+/**
+ * In-memory artifact store with optional persistence.
+ *
+ * Stores typed artifacts keyed by step name. When a persistence
+ * hook is provided, it is called asynchronously after each store
+ * operation (errors in the hook are caught and available via
+ * `getErrors()`).
+ */
+export class ArtifactStore {
+    static MAX_ERRORS = 100;
+    artifacts = new Map();
+    serializer;
+    persistHook;
+    errors = [];
+    constructor(options) {
+        this.serializer = options?.serializer ?? jsonSerializer;
+        this.persistHook = options?.onPersist;
+    }
+    /**
+     * Store an artifact for a given step name.
+     *
+     * Overwrites any existing artifact for the same step name.
+     * If a persistence hook is configured, it is called after storage.
+     */
+    async set(stepName, data) {
+        const serialized = this.serializer.serialize(data);
+        const artifact = {
+            stepName,
+            data,
+            createdAt: new Date().toISOString(),
+            serialized,
+            contentType: this.serializer.contentType,
+        };
+        this.artifacts.set(stepName, artifact);
+        if (this.persistHook) {
+            try {
+                await this.persistHook(artifact);
+            }
+            catch (err) {
+                if (this.errors.length >= ArtifactStore.MAX_ERRORS) {
+                    this.errors.shift();
+                }
+                this.errors.push({
+                    stepName,
+                    error: err instanceof Error ? err : new Error(String(err)),
+                });
+            }
+        }
+        return artifact;
+    }
+    /**
+     * Retrieve an artifact by step name.
+     *
+     * Returns undefined if no artifact exists for the given step.
+     */
+    get(stepName) {
+        return this.artifacts.get(stepName);
+    }
+    /**
+     * Check if an artifact exists for a given step name.
+     */
+    has(stepName) {
+        return this.artifacts.has(stepName);
+    }
+    /**
+     * Get all stored artifacts as an ordered array (insertion order).
+     */
+    all() {
+        return [...this.artifacts.values()];
+    }
+    /**
+     * Get all step names that have artifacts.
+     */
+    stepNames() {
+        return [...this.artifacts.keys()];
+    }
+    /**
+     * Delete an artifact by step name.
+     */
+    delete(stepName) {
+        return this.artifacts.delete(stepName);
+    }
+    /**
+     * Clear all stored artifacts.
+     */
+    clear() {
+        this.artifacts.clear();
+    }
+    /**
+     * Get persistence errors that occurred during set() calls.
+     */
+    getErrors() {
+        return this.errors;
+    }
+    /**
+     * Get the number of stored artifacts.
+     */
+    get size() {
+        return this.artifacts.size;
+    }
+    /**
+     * Deserialize a previously serialized artifact back to data.
+     */
+    deserialize(serialized) {
+        return this.serializer.deserialize(serialized);
+    }
+}
+// ---------------------------------------------------------------------------
+// Pipeline integration helper
+// ---------------------------------------------------------------------------
+/**
+ * Create a pipeline step wrapper that automatically stores the step's
+ * output as an artifact.
+ *
+ * Usage with sdkPipeline:
+ *
+ *   const store = new ArtifactStore({ onPersist: ... });
+ *
+ *   const pipeline = sdkPipeline<{ repo: string }>()
+ *     .step('lint', withArtifacts(store, async ({ state, run }) => {
+ *       const result = await run('lint', { args: { path: state.repo } });
+ *       return { lintOutput: result.result.final_output };
+ *     }))
+ *     .build();
+ */
+export function withArtifacts(store, fn) {
+    return async (ctx) => {
+        const output = await fn(ctx);
+        await store.set(ctx.stepName, output);
+        return output;
+    };
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/sdk/artifacts.js.map

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

package/dist/sdk/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/sdk/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGjD,MAAM,MAAM,uBAAuB,GAAG;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,uBAA4B;IAElD,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;CAOzC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/sdk/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,qBAAqB,CAAC;AAGxE,MAAM,MAAM,uBAAuB,GAAG;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,uBAA4B;IAElD,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;CAczC"}

package/dist/sdk/bootstrap.js

@@ -1,4 +1,4 @@
-import { ServerData } from '../session/index.js';
+import { ServerData, getCurrentEnvironment } from '../session/index.js';
 import { validateKey } from '../auth/index.js';
 /**
  * BackendBootstrap
@@ -12,9 +12,16 @@ export class BackendBootstrap {
         this.opts = opts;
     }
     async init() {
-        // Ensure we load auth from ~/.qodo/auth.key when env var is not set.
-        // validateKey throws QodoAuthError if no valid key is found.
-        validateKey();
+        const env = getCurrentEnvironment();
+        const authProvider = env.authProvider;
+        if (authProvider) {
+            // Environment-scoped auth (SDK path)
+            authProvider.validate();
+        }
+        else {
+            // Legacy fallback (CLI path)
+            validateKey();
+        }
         return await ServerData.init(this.opts.baseUrlOverride);
     }
 }

package/dist/sdk/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/sdk/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/C;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,OAAgC,EAAE;QAAlC,SAAI,GAAJ,IAAI,CAA8B;IAAG,CAAC;IAE5D,KAAK,CAAC,IAAI;QACf,qEAAqE;QACrE,6DAA6D;QAC7D,WAAW,EAAE,CAAC;QAEd,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1D,CAAC;CACF"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/sdk/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAgB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM7D;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,OAAgC,EAAE;QAAlC,SAAI,GAAJ,IAAI,CAA8B;IAAG,CAAC;IAE5D,KAAK,CAAC,IAAI;QACf,MAAM,GAAG,GAAG,qBAAqB,EAAE,CAAC;QACpC,MAAM,YAAY,GAA6B,GAAG,CAAC,YAAY,CAAC;QAEhE,IAAI,YAAY,EAAE,CAAC;YACjB,qCAAqC;YACrC,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,6BAA6B;YAC7B,WAAW,EAAE,CAAC;QAChB,CAAC;QAED,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/sdk/discovery.js

@@ -11,7 +11,7 @@ export async function findNearestAgentConfig(startDir) {
                 await fs.access(p);
                 return p;
             }
-            catch { }
+            catch { /* expected: file does not exist at this level */ }
         }
         if (current === root)
             break;

package/dist/sdk/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/sdk/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAgB;IAC3D,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IAEtC,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;IAE7D,OAAO,IAAI,EAAE,CAAC;QACZ,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACnB,OAAO,CAAC,CAAC;YACX,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;QAED,IAAI,OAAO,KAAK,IAAI;YAAE,MAAM;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM;QAC9B,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/sdk/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAgB;IAC3D,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IAEtC,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;IAE7D,OAAO,IAAI,EAAE,CAAC;QACZ,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACnB,OAAO,CAAC,CAAC;YACX,CAAC;YAAC,MAAM,CAAC,CAAC,iDAAiD,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,OAAO,KAAK,IAAI;YAAE,MAAM;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM;QAC9B,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/sdk/events.d.ts

@@ -15,6 +15,12 @@ export declare const SdkEventType: {
     readonly ToolExecuted: "sdk.tool.executed";
     readonly Error: "sdk.error";
     readonly Final: "sdk.final";
+    readonly PipelineStarted: "sdk.pipeline.started";
+    readonly PipelineStepStarted: "sdk.pipeline.step.started";
+    readonly PipelineStepCompleted: "sdk.pipeline.step.completed";
+    readonly PipelineGateEvaluated: "sdk.pipeline.gate.evaluated";
+    readonly PipelineCompleted: "sdk.pipeline.completed";
+    readonly PipelineError: "sdk.pipeline.error";
 };
 export type SdkEventTypeName = (typeof SdkEventType)[keyof typeof SdkEventType];
 export type SdkEventEnvelope<TType extends string, TData> = {
@@ -69,6 +75,8 @@ export type SdkRunStartedEvent = SdkEventEnvelope<typeof SdkEventType.RunStarted
         path?: string;
     };
     tools_auto_approved: boolean;
+    /** When true, tools are simulated via dryRunTool() and no side effects occur. */
+    dry_run?: boolean;
 }>;
 export type SdkMessageDeltaEvent = SdkEventEnvelope<typeof SdkEventType.MessageDelta, {
     message_id: string;
@@ -113,6 +121,8 @@ export type SdkToolExecutedEvent = SdkEventEnvelope<typeof SdkEventType.ToolExec
          */
         raw?: any;
     };
+    /** When true, this tool was simulated (dry run) and no side effects occurred. */
+    dry_run?: boolean;
 }>;
 export type SdkErrorEvent = SdkEventEnvelope<typeof SdkEventType.Error, {
     message: string;
@@ -136,7 +146,42 @@ export type SdkFinalEvent = SdkEventEnvelope<typeof SdkEventType.Final, {
         [k: string]: any;
     };
 }>;
-export type QodoSdkEvent = SdkInitEvent | SdkRunStartedEvent | SdkMessageDeltaEvent | SdkMessageFullEvent | SdkProgressEvent | SdkToolRequestedEvent | SdkToolApprovedEvent | SdkToolExecutedEvent | SdkErrorEvent | SdkFinalEvent;
+export type SdkPipelineStartedEvent = SdkEventEnvelope<typeof SdkEventType.PipelineStarted, {
+    /** Number of entries (sequential steps + parallel groups). */
+    entry_count: number;
+    /** Names of all steps in the pipeline. */
+    step_names: string[];
+}>;
+export type SdkPipelineStepStartedEvent = SdkEventEnvelope<typeof SdkEventType.PipelineStepStarted, {
+    step_name: string;
+    /** Whether this step is part of a parallel group. */
+    parallel: boolean;
+}>;
+export type SdkPipelineStepCompletedEvent = SdkEventEnvelope<typeof SdkEventType.PipelineStepCompleted, {
+    step_name: string;
+    status: 'completed' | 'skipped' | 'error';
+    duration_ms: number;
+    error?: string;
+}>;
+export type SdkPipelineGateEvaluatedEvent = SdkEventEnvelope<typeof SdkEventType.PipelineGateEvaluated, {
+    step_name: string;
+    /** Whether the gate passed (true) or the step was skipped (false). */
+    passed: boolean;
+}>;
+export type SdkPipelineCompletedEvent = SdkEventEnvelope<typeof SdkEventType.PipelineCompleted, {
+    /** Total duration of the pipeline run in ms. */
+    duration_ms: number;
+    /** Number of steps completed. */
+    steps_completed: number;
+    /** Number of steps skipped. */
+    steps_skipped: number;
+}>;
+export type SdkPipelineErrorEvent = SdkEventEnvelope<typeof SdkEventType.PipelineError, {
+    step_name: string;
+    message: string;
+    cause?: any;
+}>;
+export type QodoSdkEvent = SdkInitEvent | SdkRunStartedEvent | SdkMessageDeltaEvent | SdkMessageFullEvent | SdkProgressEvent | SdkToolRequestedEvent | SdkToolApprovedEvent | SdkToolExecutedEvent | SdkErrorEvent | SdkFinalEvent | SdkPipelineStartedEvent | SdkPipelineStepStartedEvent | SdkPipelineStepCompletedEvent | SdkPipelineGateEvaluatedEvent | SdkPipelineCompletedEvent | SdkPipelineErrorEvent;
 export declare function createSdkEvent<TType extends QodoSdkEvent['type'], TData>(args: {
     type: TType;
     run_id: string;

package/dist/sdk/events.d.ts.map

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

package/dist/sdk/events.js

@@ -16,6 +16,12 @@ export const SdkEventType = {
     ToolExecuted: 'sdk.tool.executed',
     Error: 'sdk.error',
     Final: 'sdk.final',
+    PipelineStarted: 'sdk.pipeline.started',
+    PipelineStepStarted: 'sdk.pipeline.step.started',
+    PipelineStepCompleted: 'sdk.pipeline.step.completed',
+    PipelineGateEvaluated: 'sdk.pipeline.gate.evaluated',
+    PipelineCompleted: 'sdk.pipeline.completed',
+    PipelineError: 'sdk.pipeline.error',
 };
 export function createSdkEvent(args) {
     return {

package/dist/sdk/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/sdk/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAsB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,iBAAiB;IAC7B,YAAY,EAAE,mBAAmB;IACjC,WAAW,EAAE,kBAAkB;IAC/B,QAAQ,EAAE,cAAc;IACxB,aAAa,EAAE,oBAAoB;IACnC,YAAY,EAAE,mBAAmB;IACjC,YAAY,EAAE,mBAAmB;IACjC,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE,WAAW;CACV,CAAC;AA+JX,MAAM,UAAU,cAAc,CAA4C,IASzE;IACC,OAAO;QACL,QAAQ,EAAE,eAAe;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;QACvC,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,IAAI,EAAE,IAAI,CAAC,IAAI;KACkB,CAAC;AACtC,CAAC;AAQD;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,EAAgB,EAAE,QAA0B;IACxE,MAAM,EAAE,GAAI,QAAgB,CAAC,EAAE,CAAC,IAAI,CAA+C,CAAC;IACpF,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACtB,OAAO,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,yDAAyD;IACzD,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/sdk/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAsB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,iBAAiB;IAC7B,YAAY,EAAE,mBAAmB;IACjC,WAAW,EAAE,kBAAkB;IAC/B,QAAQ,EAAE,cAAc;IACxB,aAAa,EAAE,oBAAoB;IACnC,YAAY,EAAE,mBAAmB;IACjC,YAAY,EAAE,mBAAmB;IACjC,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE,WAAW;IAClB,eAAe,EAAE,sBAAsB;IACvC,mBAAmB,EAAE,2BAA2B;IAChD,qBAAqB,EAAE,6BAA6B;IACpD,qBAAqB,EAAE,6BAA6B;IACpD,iBAAiB,EAAE,wBAAwB;IAC3C,aAAa,EAAE,oBAAoB;CAC3B,CAAC;AAuNX,MAAM,UAAU,cAAc,CAA4C,IASzE;IACC,OAAO;QACL,QAAQ,EAAE,eAAe;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;QACvC,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,IAAI,EAAE,IAAI,CAAC,IAAI;KACkB,CAAC;AACtC,CAAC;AAQD;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,EAAgB,EAAE,QAA0B;IACxE,MAAM,EAAE,GAAI,QAAgB,CAAC,EAAE,CAAC,IAAI,CAA+C,CAAC;IACpF,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACtB,OAAO,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,yDAAyD;IACzD,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC"}

package/dist/sdk/middleware.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Public Tool Middleware API for SDK consumers.
+ *
+ * Middleware hooks run around tool execution, allowing consumers to inspect,
+ * modify, or log tool calls and results without touching internal code.
+ *
+ * Safety guarantees:
+ * - Protected fields (identifier, server_name, session_id) cannot be overwritten
+ * - User middleware is wrapped in a configurable timeout (default 10 s)
+ * - Errors in middleware are caught and reported, never crash the run
+ */
+import type { ToolData, ToolResult } from '../api/types.js';
+/** Default timeout for user-registered middleware hooks (ms). */
+export declare const MIDDLEWARE_TIMEOUT_MS = 10000;
+/**
+ * Fields on ToolData that middleware is NOT allowed to overwrite.
+ * These are set by the engine and are essential for routing / identity.
+ */
+export declare const PROTECTED_TOOL_FIELDS: ReadonlySet<string>;
+/**
+ * Public middleware interface that SDK consumers implement.
+ *
+ * Both hooks are optional. Returning `undefined` / `void` from a hook means
+ * "no changes" — the original data flows through.
+ */
+export interface ToolMiddleware {
+    /** Display name for logging / error messages. */
+    name?: string;
+    /**
+     * Called before a tool is executed.
+     * May return partial ToolData overrides (protected fields are stripped).
+     */
+    preExecute?(toolData: Readonly<ToolData>): Promise<Partial<ToolData> | void> | Partial<ToolData> | void;
+    /**
+     * Called after a tool is executed with the result.
+     * May return a replacement ToolResult.
+     */
+    postExecute?(toolData: Readonly<ToolData>, result: ToolResult): Promise<ToolResult | void> | ToolResult | void;
+}
+/**
+ * Error class for middleware failures.
+ * Contains the middleware name and phase for diagnostics.
+ */
+export declare class ToolMiddlewareError extends Error {
+    readonly middlewareName: string;
+    readonly phase: 'preExecute' | 'postExecute';
+    readonly cause?: Error | undefined;
+    constructor(message: string, middlewareName: string, phase: 'preExecute' | 'postExecute', cause?: Error | undefined);
+}
+/**
+ * Strip protected fields from a partial ToolData override.
+ */
+export declare function stripProtectedFields(partial: Partial<ToolData>): Partial<ToolData>;
+/**
+ * Wrap an async function with a timeout.
+ * Rejects with ToolMiddlewareError if the timeout expires.
+ */
+export declare function withTimeout<T>(fn: () => Promise<T> | T, timeoutMs: number, middlewareName: string, phase: 'preExecute' | 'postExecute'): Promise<T>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/sdk/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/sdk/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE5D,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAIpD,CAAC;AAEH;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,UAAU,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAExG;;;OAGG;IACH,WAAW,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC;CAChH;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,cAAc,EAAE,MAAM;aACtB,KAAK,EAAE,YAAY,GAAG,aAAa;aACnC,KAAK,CAAC,EAAE,KAAK;gBAH7B,OAAO,EAAE,MAAM,EACC,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,YAAY,GAAG,aAAa,EACnC,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAMlF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,YAAY,GAAG,aAAa,GAClC,OAAO,CAAC,CAAC,CAAC,CAsBZ"}

package/dist/sdk/middleware.js

@@ -0,0 +1,69 @@
+/**
+ * Public Tool Middleware API for SDK consumers.
+ *
+ * Middleware hooks run around tool execution, allowing consumers to inspect,
+ * modify, or log tool calls and results without touching internal code.
+ *
+ * Safety guarantees:
+ * - Protected fields (identifier, server_name, session_id) cannot be overwritten
+ * - User middleware is wrapped in a configurable timeout (default 10 s)
+ * - Errors in middleware are caught and reported, never crash the run
+ */
+/** Default timeout for user-registered middleware hooks (ms). */
+export const MIDDLEWARE_TIMEOUT_MS = 10_000;
+/**
+ * Fields on ToolData that middleware is NOT allowed to overwrite.
+ * These are set by the engine and are essential for routing / identity.
+ */
+export const PROTECTED_TOOL_FIELDS = new Set([
+    'identifier',
+    'server_name',
+    'session_id',
+]);
+/**
+ * Error class for middleware failures.
+ * Contains the middleware name and phase for diagnostics.
+ */
+export class ToolMiddlewareError extends Error {
+    middlewareName;
+    phase;
+    cause;
+    constructor(message, middlewareName, phase, cause) {
+        super(message);
+        this.middlewareName = middlewareName;
+        this.phase = phase;
+        this.cause = cause;
+        this.name = 'ToolMiddlewareError';
+    }
+}
+/**
+ * Strip protected fields from a partial ToolData override.
+ */
+export function stripProtectedFields(partial) {
+    const cleaned = { ...partial };
+    for (const field of PROTECTED_TOOL_FIELDS) {
+        delete cleaned[field];
+    }
+    return cleaned;
+}
+/**
+ * Wrap an async function with a timeout.
+ * Rejects with ToolMiddlewareError if the timeout expires.
+ */
+export function withTimeout(fn, timeoutMs, middlewareName, phase) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new ToolMiddlewareError(`Middleware "${middlewareName}" timed out after ${timeoutMs}ms in ${phase}`, middlewareName, phase));
+        }, timeoutMs);
+        Promise.resolve(fn())
+            .then((result) => {
+            clearTimeout(timer);
+            resolve(result);
+        })
+            .catch((err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=middleware.js.map

package/dist/sdk/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/sdk/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,iEAAiE;AACjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAwB,IAAI,GAAG,CAAC;IAChE,YAAY;IACZ,aAAa;IACb,YAAY;CACb,CAAC,CAAC;AAyBH;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAG1B;IACA;IACA;IAJlB,YACE,OAAe,EACC,cAAsB,EACtB,KAAmC,EACnC,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,mBAAc,GAAd,cAAc,CAAQ;QACtB,UAAK,GAAL,KAAK,CAA8B;QACnC,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,qBAAqB,EAAE,CAAC;QAC1C,OAAQ,OAAe,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,EAAwB,EACxB,SAAiB,EACjB,cAAsB,EACtB,KAAmC;IAEnC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CACJ,IAAI,mBAAmB,CACrB,eAAe,cAAc,qBAAqB,SAAS,SAAS,KAAK,EAAE,EAC3E,cAAc,EACd,KAAK,CACN,CACF,CAAC;QACJ,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;aAClB,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACL,CAAC"}