@bastani/atomic 0.9.25-alpha.2 → 0.9.25-alpha.4

package/dist/core/extensions/workflow-run-control-hub.js

@@ -0,0 +1,57 @@
+import { WorkflowRunControlUnavailableError, } from "./workflow-run-control.js";
+/** Holds the run-control implementation that the workflows extension registers for one extension generation. */
+export class WorkflowRunControlHub {
+    control;
+    disposed = false;
+    register(control) {
+        if (this.disposed)
+            return { dispose: () => { } };
+        this.control = control;
+        return {
+            dispose: () => {
+                if (this.control === control)
+                    this.control = undefined;
+            },
+        };
+    }
+    current() {
+        return this.control;
+    }
+    dispose() {
+        this.disposed = true;
+        this.control = undefined;
+    }
+}
+/** Stable per-session handle that follows the current extension generation across reloads. */
+export class SessionWorkflowsHandle {
+    resolve;
+    constructor(resolve) {
+        this.resolve = resolve;
+    }
+    control() {
+        const control = this.resolve();
+        if (control === undefined)
+            throw new WorkflowRunControlUnavailableError();
+        return control;
+    }
+    async listRuns(filter) {
+        return this.control().listRuns(filter);
+    }
+    async getRun(runId) {
+        return this.control().getRun(runId);
+    }
+    async getStages(runId, filter) {
+        return this.control().getStages(runId, filter);
+    }
+    async pause(target, options) {
+        const control = this.control();
+        return typeof target === "string" ? control.pause(target, options) : control.pause(target);
+    }
+    async quit(target) {
+        return this.control().quit(target);
+    }
+    async resume(runId, options) {
+        return this.control().resume(runId, options);
+    }
+}
+//# sourceMappingURL=workflow-run-control-hub.js.map

package/dist/core/extensions/workflow-run-control-hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-run-control-hub.js","sourceRoot":"","sources":["../../../src/core/extensions/workflow-run-control-hub.ts"],"names":[],"mappings":"AAAA,OAAO,EAKN,kCAAkC,GAQlC,MAAM,2BAA2B,CAAC;AAEnC,gHAAgH;AAChH,MAAM,OAAO,qBAAqB;IACzB,OAAO,CAA+B;IACtC,QAAQ,GAAG,KAAK,CAAC;IAEzB,QAAQ,CAAC,OAAyB;QACjC,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO;YACN,OAAO,EAAE,GAAG,EAAE;gBACb,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;oBAAE,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACxD,CAAC;SACD,CAAC;IACH,CAAC;IAED,OAAO;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,OAAO;QACN,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC1B,CAAC;CACD;AAED,8FAA8F;AAC9F,MAAM,OAAO,sBAAsB;IACjB,OAAO,CAAqC;IAE7D,YAAY,OAA2C;QACtD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAEO,OAAO;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,kCAAkC,EAAE,CAAC;QAC1E,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA8B;QAC5C,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACzB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,MAAgC;QAC9D,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAID,KAAK,CAAC,KAAK,CACV,MAAqC,EACrC,OAAiC;QAEjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5F,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAqC;QAC/C,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAkC;QAC7D,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;CACD","sourcesContent":["import {\n\ttype SessionWorkflows,\n\ttype WorkflowRunAllTarget,\n\ttype WorkflowRunControlOutcome,\n\ttype WorkflowRunControlRegistration,\n\tWorkflowRunControlUnavailableError,\n\ttype WorkflowRunDetail,\n\ttype WorkflowRunListFilter,\n\ttype WorkflowRunPauseOptions,\n\ttype WorkflowRunResumeOptions,\n\ttype WorkflowRunStageSummary,\n\ttype WorkflowRunSummary,\n\ttype WorkflowStageListFilter,\n} from \"./workflow-run-control.js\";\n\n/** Holds the run-control implementation that the workflows extension registers for one extension generation. */\nexport class WorkflowRunControlHub {\n\tprivate control: SessionWorkflows | undefined;\n\tprivate disposed = false;\n\n\tregister(control: SessionWorkflows): WorkflowRunControlRegistration {\n\t\tif (this.disposed) return { dispose: () => {} };\n\t\tthis.control = control;\n\t\treturn {\n\t\t\tdispose: () => {\n\t\t\t\tif (this.control === control) this.control = undefined;\n\t\t\t},\n\t\t};\n\t}\n\n\tcurrent(): SessionWorkflows | undefined {\n\t\treturn this.control;\n\t}\n\n\tdispose(): void {\n\t\tthis.disposed = true;\n\t\tthis.control = undefined;\n\t}\n}\n\n/** Stable per-session handle that follows the current extension generation across reloads. */\nexport class SessionWorkflowsHandle implements SessionWorkflows {\n\tprivate readonly resolve: () => SessionWorkflows | undefined;\n\n\tconstructor(resolve: () => SessionWorkflows | undefined) {\n\t\tthis.resolve = resolve;\n\t}\n\n\tprivate control(): SessionWorkflows {\n\t\tconst control = this.resolve();\n\t\tif (control === undefined) throw new WorkflowRunControlUnavailableError();\n\t\treturn control;\n\t}\n\n\tasync listRuns(filter?: WorkflowRunListFilter): Promise<readonly WorkflowRunSummary[]> {\n\t\treturn this.control().listRuns(filter);\n\t}\n\n\tasync getRun(runId: string): Promise<WorkflowRunDetail> {\n\t\treturn this.control().getRun(runId);\n\t}\n\n\tasync getStages(runId: string, filter?: WorkflowStageListFilter): Promise<readonly WorkflowRunStageSummary[]> {\n\t\treturn this.control().getStages(runId, filter);\n\t}\n\n\tpause(runId: string, options?: WorkflowRunPauseOptions): Promise<WorkflowRunControlOutcome>;\n\tpause(target: WorkflowRunAllTarget): Promise<WorkflowRunControlOutcome>;\n\tasync pause(\n\t\ttarget: string | WorkflowRunAllTarget,\n\t\toptions?: WorkflowRunPauseOptions,\n\t): Promise<WorkflowRunControlOutcome> {\n\t\tconst control = this.control();\n\t\treturn typeof target === \"string\" ? control.pause(target, options) : control.pause(target);\n\t}\n\n\tasync quit(target: string | WorkflowRunAllTarget): Promise<WorkflowRunControlOutcome> {\n\t\treturn this.control().quit(target);\n\t}\n\n\tasync resume(runId: string, options?: WorkflowRunResumeOptions): Promise<WorkflowRunControlOutcome> {\n\t\treturn this.control().resume(runId, options);\n\t}\n}\n"]}

package/dist/core/extensions/workflow-run-control.d.ts

@@ -0,0 +1,163 @@
+import type { WorkflowRunStatus, WorkflowStageStatus } from "./workflow-events.js";
+export type WorkflowRunJsonValue = string | number | boolean | null | readonly WorkflowRunJsonValue[] | WorkflowRunJsonObject;
+export interface WorkflowRunJsonObject {
+    readonly [key: string]: WorkflowRunJsonValue | undefined;
+}
+export type WorkflowRunFilterStatus = WorkflowRunStatus | WorkflowStageStatus | "awaiting_input";
+export interface WorkflowRunListFilter {
+    /** Run statuses match directly; `awaiting_input` selects runs with an unanswered prompt. */
+    readonly status?: WorkflowRunFilterStatus;
+}
+export interface WorkflowStageListFilter {
+    readonly status?: WorkflowStageStatus;
+}
+export interface WorkflowRunActiveStage {
+    readonly stageId: string;
+    readonly name: string;
+    readonly status: WorkflowStageStatus;
+}
+export interface WorkflowRunAwaitingInput {
+    readonly stageId?: string;
+    readonly stageName?: string;
+    readonly promptId?: string;
+    readonly promptKind?: string;
+    readonly message?: string;
+}
+/** The concise per-run data that the `workflow` tool's `status` action lists. */
+export interface WorkflowRunSummary {
+    readonly runId: string;
+    readonly name: string;
+    readonly status: WorkflowRunStatus;
+    readonly startedAt: number;
+    readonly endedAt?: number;
+    readonly elapsedMs: number;
+    readonly activeStages: readonly WorkflowRunActiveStage[];
+    readonly awaitingInputCount: number;
+    readonly awaitingInput: readonly WorkflowRunAwaitingInput[];
+    readonly exitReason?: string;
+    readonly error?: string;
+}
+export interface WorkflowRunStageSummary {
+    readonly id: string;
+    readonly name: string;
+    readonly status: WorkflowStageStatus;
+    readonly sessionId?: string;
+    readonly error?: string;
+    readonly skippedReason?: string;
+    readonly awaitingInputSince?: number;
+}
+/** The per-run detail that the `workflow` tool's `status` action returns for one run id. */
+export interface WorkflowRunDetail {
+    readonly runId: string;
+    readonly rootRunId?: string;
+    readonly name: string;
+    readonly status: WorkflowRunStatus | "crashed";
+    readonly startedAt: number;
+    readonly endedAt?: number;
+    readonly durationMs?: number;
+    readonly inputs: WorkflowRunJsonObject;
+    readonly stages: readonly WorkflowRunStageSummary[];
+    readonly result?: WorkflowRunJsonObject;
+    readonly error?: string;
+    readonly exitReason?: string;
+    readonly resumable?: boolean;
+    readonly resumeGuidance?: string;
+    readonly ownerActiveElsewhere?: boolean;
+}
+export interface WorkflowRunAllTarget {
+    readonly all: true;
+}
+export interface WorkflowRunPauseOptions {
+    /** Pause one stage instead of the whole run. */
+    readonly stageId?: string;
+}
+export interface WorkflowRunResumeOptions {
+    /** Resume one paused stage instead of the whole run. */
+    readonly stageId?: string;
+    /** Message delivered to each resumed stage. */
+    readonly message?: string;
+}
+export type WorkflowRunControlStatus = "ok" | "running" | "paused" | "partial" | "noop" | "cancelled";
+/** A run that a batch pause or quit could not stop; it may still be active. */
+export interface WorkflowRunControlFailedRun {
+    readonly runId: string;
+    /** Machine-readable refusal, such as `not_found`, `no_active_stages` or `pause_failed`. */
+    readonly reason: string;
+    readonly message?: string;
+}
+/**
+ * The acknowledged result of a pause, quit or resume request, as the `workflow`
+ * tool reports it. `runId` is `--all` for a batch request. `noop` means the request was
+ * understood and found nothing to change; `partial` means only part of the
+ * request took effect. For a batch pause or quit, `failedRuns` names every run that
+ * could not be stopped, so a `partial` outcome is never a complete stop.
+ */
+export interface WorkflowRunControlOutcome {
+    readonly action: "pause" | "quit" | "resume";
+    readonly runId: string;
+    readonly status: WorkflowRunControlStatus;
+    readonly message: string;
+    readonly stageId?: string;
+    readonly workflowStatus?: WorkflowRunStatus;
+    readonly abandoned?: boolean;
+    readonly failedRuns?: readonly WorkflowRunControlFailedRun[];
+}
+/** Typed run management for the workflow runs owned by one session. */
+export interface SessionWorkflows {
+    listRuns(filter?: WorkflowRunListFilter): Promise<readonly WorkflowRunSummary[]>;
+    getRun(runId: string): Promise<WorkflowRunDetail>;
+    getStages(runId: string, filter?: WorkflowStageListFilter): Promise<readonly WorkflowRunStageSummary[]>;
+    pause(runId: string, options?: WorkflowRunPauseOptions): Promise<WorkflowRunControlOutcome>;
+    pause(target: WorkflowRunAllTarget): Promise<WorkflowRunControlOutcome>;
+    quit(target: string | WorkflowRunAllTarget): Promise<WorkflowRunControlOutcome>;
+    resume(runId: string, options?: WorkflowRunResumeOptions): Promise<WorkflowRunControlOutcome>;
+}
+export interface WorkflowRunControlRegistration {
+    dispose(): void;
+}
+export type WorkflowRunControlErrorCode = "WORKFLOW_RUN_NOT_FOUND" | "WORKFLOW_RUN_OWNED_ELSEWHERE" | "WORKFLOW_RUN_NOT_RESUMABLE" | "WORKFLOW_STAGE_NOT_FOUND" | "WORKFLOW_STAGE_AMBIGUOUS" | "WORKFLOW_STAGE_RESUME_UNSUPPORTED" | "WORKFLOW_RUN_DATABASE" | "WORKFLOW_RUN_CONTROL_FAILED" | "WORKFLOW_RUN_CONTROL_UNAVAILABLE";
+export interface WorkflowRunControlErrorOptions extends ErrorOptions {
+    readonly runId?: string;
+    readonly failedRuns?: readonly WorkflowRunControlFailedRun[];
+}
+/** Base class for every failure reported by {@link SessionWorkflows}; branch on `code`. */
+export declare class WorkflowRunControlError extends Error {
+    readonly code: WorkflowRunControlErrorCode;
+    readonly runId?: string;
+    /** Runs a batch pause or quit could not stop, when the whole batch was refused. */
+    readonly failedRuns?: readonly WorkflowRunControlFailedRun[];
+    constructor(code: WorkflowRunControlErrorCode, message: string, options?: WorkflowRunControlErrorOptions);
+}
+/** The run id is unknown, malformed, or an ambiguous prefix. */
+export declare class WorkflowRunNotFoundError extends WorkflowRunControlError {
+    constructor(message: string, options?: WorkflowRunControlErrorOptions);
+}
+/** The run belongs to another session or is executing in another live Atomic process. */
+export declare class WorkflowRunOwnershipError extends WorkflowRunControlError {
+    constructor(message: string, options?: WorkflowRunControlErrorOptions);
+}
+/** The run has no continuation to resume: it completed, was killed, or has no durable progress. */
+export declare class WorkflowRunNotResumableError extends WorkflowRunControlError {
+    constructor(message: string, options?: WorkflowRunControlErrorOptions);
+}
+/** The stage identifier matches no stage or tool node of the run. */
+export declare class WorkflowStageNotFoundError extends WorkflowRunControlError {
+    constructor(message: string, options?: WorkflowRunControlErrorOptions);
+}
+/** The stage identifier matches more than one stage or tool node; pass a more specific identifier. */
+export declare class WorkflowStageAmbiguousError extends WorkflowRunControlError {
+    constructor(message: string, options?: WorkflowRunControlErrorOptions);
+}
+/** A durable run can only be resumed whole; resume it without a stage identifier. */
+export declare class WorkflowStageResumeUnsupportedError extends WorkflowRunControlError {
+    constructor(message: string, options?: WorkflowRunControlErrorOptions);
+}
+/** Workflow durability (the run database) is unavailable, shut down, or failed. */
+export declare class WorkflowRunDatabaseError extends WorkflowRunControlError {
+    constructor(message: string, options?: WorkflowRunControlErrorOptions);
+}
+/** The workflows extension is not loaded for this session, or the session was disposed. */
+export declare class WorkflowRunControlUnavailableError extends WorkflowRunControlError {
+    constructor(message?: string, options?: WorkflowRunControlErrorOptions);
+}
+//# sourceMappingURL=workflow-run-control.d.ts.map

package/dist/core/extensions/workflow-run-control.d.ts.map

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

package/dist/core/extensions/workflow-run-control.js

@@ -0,0 +1,73 @@
+/** Base class for every failure reported by {@link SessionWorkflows}; branch on `code`. */
+export class WorkflowRunControlError extends Error {
+    code;
+    runId;
+    /** Runs a batch pause or quit could not stop, when the whole batch was refused. */
+    failedRuns;
+    constructor(code, message, options = {}) {
+        super(message, options);
+        this.name = "WorkflowRunControlError";
+        this.code = code;
+        if (options.runId !== undefined)
+            this.runId = options.runId;
+        if (options.failedRuns !== undefined)
+            this.failedRuns = options.failedRuns;
+    }
+}
+/** The run id is unknown, malformed, or an ambiguous prefix. */
+export class WorkflowRunNotFoundError extends WorkflowRunControlError {
+    constructor(message, options) {
+        super("WORKFLOW_RUN_NOT_FOUND", message, options);
+        this.name = "WorkflowRunNotFoundError";
+    }
+}
+/** The run belongs to another session or is executing in another live Atomic process. */
+export class WorkflowRunOwnershipError extends WorkflowRunControlError {
+    constructor(message, options) {
+        super("WORKFLOW_RUN_OWNED_ELSEWHERE", message, options);
+        this.name = "WorkflowRunOwnershipError";
+    }
+}
+/** The run has no continuation to resume: it completed, was killed, or has no durable progress. */
+export class WorkflowRunNotResumableError extends WorkflowRunControlError {
+    constructor(message, options) {
+        super("WORKFLOW_RUN_NOT_RESUMABLE", message, options);
+        this.name = "WorkflowRunNotResumableError";
+    }
+}
+/** The stage identifier matches no stage or tool node of the run. */
+export class WorkflowStageNotFoundError extends WorkflowRunControlError {
+    constructor(message, options) {
+        super("WORKFLOW_STAGE_NOT_FOUND", message, options);
+        this.name = "WorkflowStageNotFoundError";
+    }
+}
+/** The stage identifier matches more than one stage or tool node; pass a more specific identifier. */
+export class WorkflowStageAmbiguousError extends WorkflowRunControlError {
+    constructor(message, options) {
+        super("WORKFLOW_STAGE_AMBIGUOUS", message, options);
+        this.name = "WorkflowStageAmbiguousError";
+    }
+}
+/** A durable run can only be resumed whole; resume it without a stage identifier. */
+export class WorkflowStageResumeUnsupportedError extends WorkflowRunControlError {
+    constructor(message, options) {
+        super("WORKFLOW_STAGE_RESUME_UNSUPPORTED", message, options);
+        this.name = "WorkflowStageResumeUnsupportedError";
+    }
+}
+/** Workflow durability (the run database) is unavailable, shut down, or failed. */
+export class WorkflowRunDatabaseError extends WorkflowRunControlError {
+    constructor(message, options) {
+        super("WORKFLOW_RUN_DATABASE", message, options);
+        this.name = "WorkflowRunDatabaseError";
+    }
+}
+/** The workflows extension is not loaded for this session, or the session was disposed. */
+export class WorkflowRunControlUnavailableError extends WorkflowRunControlError {
+    constructor(message = "Workflow run control is unavailable for this session.", options) {
+        super("WORKFLOW_RUN_CONTROL_UNAVAILABLE", message, options);
+        this.name = "WorkflowRunControlUnavailableError";
+    }
+}
+//# sourceMappingURL=workflow-run-control.js.map

package/dist/core/extensions/workflow-run-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-run-control.js","sourceRoot":"","sources":["../../../src/core/extensions/workflow-run-control.ts"],"names":[],"mappings":"AA8JA,2FAA2F;AAC3F,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACxC,IAAI,CAA8B;IAClC,KAAK,CAAU;IACxB,mFAAmF;IAC1E,UAAU,CAA0C;IAE7D,YAAY,IAAiC,EAAE,OAAe,EAAE,OAAO,GAAmC,EAAE;QAC3G,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5D,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAC5E,CAAC;CACD;AAED,gEAAgE;AAChE,MAAM,OAAO,wBAAyB,SAAQ,uBAAuB;IACpE,YAAY,OAAe,EAAE,OAAwC;QACpE,KAAK,CAAC,wBAAwB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACxC,CAAC;CACD;AAED,yFAAyF;AACzF,MAAM,OAAO,yBAA0B,SAAQ,uBAAuB;IACrE,YAAY,OAAe,EAAE,OAAwC;QACpE,KAAK,CAAC,8BAA8B,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IACzC,CAAC;CACD;AAED,mGAAmG;AACnG,MAAM,OAAO,4BAA6B,SAAQ,uBAAuB;IACxE,YAAY,OAAe,EAAE,OAAwC;QACpE,KAAK,CAAC,4BAA4B,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC5C,CAAC;CACD;AAED,qEAAqE;AACrE,MAAM,OAAO,0BAA2B,SAAQ,uBAAuB;IACtE,YAAY,OAAe,EAAE,OAAwC;QACpE,KAAK,CAAC,0BAA0B,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC1C,CAAC;CACD;AAED,sGAAsG;AACtG,MAAM,OAAO,2BAA4B,SAAQ,uBAAuB;IACvE,YAAY,OAAe,EAAE,OAAwC;QACpE,KAAK,CAAC,0BAA0B,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC3C,CAAC;CACD;AAED,qFAAqF;AACrF,MAAM,OAAO,mCAAoC,SAAQ,uBAAuB;IAC/E,YAAY,OAAe,EAAE,OAAwC;QACpE,KAAK,CAAC,mCAAmC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,qCAAqC,CAAC;IACnD,CAAC;CACD;AAED,mFAAmF;AACnF,MAAM,OAAO,wBAAyB,SAAQ,uBAAuB;IACpE,YAAY,OAAe,EAAE,OAAwC;QACpE,KAAK,CAAC,uBAAuB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACxC,CAAC;CACD;AAED,2FAA2F;AAC3F,MAAM,OAAO,kCAAmC,SAAQ,uBAAuB;IAC9E,YACC,OAAO,GAAG,uDAAuD,EACjE,OAAwC;QAExC,KAAK,CAAC,kCAAkC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,oCAAoC,CAAC;IAClD,CAAC;CACD","sourcesContent":["import type { WorkflowRunStatus, WorkflowStageStatus } from \"./workflow-events.js\";\n\nexport type WorkflowRunJsonValue =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| readonly WorkflowRunJsonValue[]\n\t| WorkflowRunJsonObject;\n\nexport interface WorkflowRunJsonObject {\n\treadonly [key: string]: WorkflowRunJsonValue | undefined;\n}\n\nexport type WorkflowRunFilterStatus = WorkflowRunStatus | WorkflowStageStatus | \"awaiting_input\";\n\nexport interface WorkflowRunListFilter {\n\t/** Run statuses match directly; `awaiting_input` selects runs with an unanswered prompt. */\n\treadonly status?: WorkflowRunFilterStatus;\n}\n\nexport interface WorkflowStageListFilter {\n\treadonly status?: WorkflowStageStatus;\n}\n\nexport interface WorkflowRunActiveStage {\n\treadonly stageId: string;\n\treadonly name: string;\n\treadonly status: WorkflowStageStatus;\n}\n\nexport interface WorkflowRunAwaitingInput {\n\treadonly stageId?: string;\n\treadonly stageName?: string;\n\treadonly promptId?: string;\n\treadonly promptKind?: string;\n\treadonly message?: string;\n}\n\n/** The concise per-run data that the `workflow` tool's `status` action lists. */\nexport interface WorkflowRunSummary {\n\treadonly runId: string;\n\treadonly name: string;\n\treadonly status: WorkflowRunStatus;\n\treadonly startedAt: number;\n\treadonly endedAt?: number;\n\treadonly elapsedMs: number;\n\treadonly activeStages: readonly WorkflowRunActiveStage[];\n\treadonly awaitingInputCount: number;\n\treadonly awaitingInput: readonly WorkflowRunAwaitingInput[];\n\treadonly exitReason?: string;\n\treadonly error?: string;\n}\n\nexport interface WorkflowRunStageSummary {\n\treadonly id: string;\n\treadonly name: string;\n\treadonly status: WorkflowStageStatus;\n\treadonly sessionId?: string;\n\treadonly error?: string;\n\treadonly skippedReason?: string;\n\treadonly awaitingInputSince?: number;\n}\n\n/** The per-run detail that the `workflow` tool's `status` action returns for one run id. */\nexport interface WorkflowRunDetail {\n\treadonly runId: string;\n\treadonly rootRunId?: string;\n\treadonly name: string;\n\treadonly status: WorkflowRunStatus | \"crashed\";\n\treadonly startedAt: number;\n\treadonly endedAt?: number;\n\treadonly durationMs?: number;\n\treadonly inputs: WorkflowRunJsonObject;\n\treadonly stages: readonly WorkflowRunStageSummary[];\n\treadonly result?: WorkflowRunJsonObject;\n\treadonly error?: string;\n\treadonly exitReason?: string;\n\treadonly resumable?: boolean;\n\treadonly resumeGuidance?: string;\n\treadonly ownerActiveElsewhere?: boolean;\n}\n\nexport interface WorkflowRunAllTarget {\n\treadonly all: true;\n}\n\nexport interface WorkflowRunPauseOptions {\n\t/** Pause one stage instead of the whole run. */\n\treadonly stageId?: string;\n}\n\nexport interface WorkflowRunResumeOptions {\n\t/** Resume one paused stage instead of the whole run. */\n\treadonly stageId?: string;\n\t/** Message delivered to each resumed stage. */\n\treadonly message?: string;\n}\n\nexport type WorkflowRunControlStatus = \"ok\" | \"running\" | \"paused\" | \"partial\" | \"noop\" | \"cancelled\";\n\n/** A run that a batch pause or quit could not stop; it may still be active. */\nexport interface WorkflowRunControlFailedRun {\n\treadonly runId: string;\n\t/** Machine-readable refusal, such as `not_found`, `no_active_stages` or `pause_failed`. */\n\treadonly reason: string;\n\treadonly message?: string;\n}\n\n/**\n * The acknowledged result of a pause, quit or resume request, as the `workflow`\n * tool reports it. `runId` is `--all` for a batch request. `noop` means the request was\n * understood and found nothing to change; `partial` means only part of the\n * request took effect. For a batch pause or quit, `failedRuns` names every run that\n * could not be stopped, so a `partial` outcome is never a complete stop.\n */\nexport interface WorkflowRunControlOutcome {\n\treadonly action: \"pause\" | \"quit\" | \"resume\";\n\treadonly runId: string;\n\treadonly status: WorkflowRunControlStatus;\n\treadonly message: string;\n\treadonly stageId?: string;\n\treadonly workflowStatus?: WorkflowRunStatus;\n\treadonly abandoned?: boolean;\n\treadonly failedRuns?: readonly WorkflowRunControlFailedRun[];\n}\n\n/** Typed run management for the workflow runs owned by one session. */\nexport interface SessionWorkflows {\n\tlistRuns(filter?: WorkflowRunListFilter): Promise<readonly WorkflowRunSummary[]>;\n\tgetRun(runId: string): Promise<WorkflowRunDetail>;\n\tgetStages(runId: string, filter?: WorkflowStageListFilter): Promise<readonly WorkflowRunStageSummary[]>;\n\tpause(runId: string, options?: WorkflowRunPauseOptions): Promise<WorkflowRunControlOutcome>;\n\tpause(target: WorkflowRunAllTarget): Promise<WorkflowRunControlOutcome>;\n\tquit(target: string | WorkflowRunAllTarget): Promise<WorkflowRunControlOutcome>;\n\tresume(runId: string, options?: WorkflowRunResumeOptions): Promise<WorkflowRunControlOutcome>;\n}\n\nexport interface WorkflowRunControlRegistration {\n\tdispose(): void;\n}\n\nexport type WorkflowRunControlErrorCode =\n\t| \"WORKFLOW_RUN_NOT_FOUND\"\n\t| \"WORKFLOW_RUN_OWNED_ELSEWHERE\"\n\t| \"WORKFLOW_RUN_NOT_RESUMABLE\"\n\t| \"WORKFLOW_STAGE_NOT_FOUND\"\n\t| \"WORKFLOW_STAGE_AMBIGUOUS\"\n\t| \"WORKFLOW_STAGE_RESUME_UNSUPPORTED\"\n\t| \"WORKFLOW_RUN_DATABASE\"\n\t| \"WORKFLOW_RUN_CONTROL_FAILED\"\n\t| \"WORKFLOW_RUN_CONTROL_UNAVAILABLE\";\n\nexport interface WorkflowRunControlErrorOptions extends ErrorOptions {\n\treadonly runId?: string;\n\treadonly failedRuns?: readonly WorkflowRunControlFailedRun[];\n}\n\n/** Base class for every failure reported by {@link SessionWorkflows}; branch on `code`. */\nexport class WorkflowRunControlError extends Error {\n\treadonly code: WorkflowRunControlErrorCode;\n\treadonly runId?: string;\n\t/** Runs a batch pause or quit could not stop, when the whole batch was refused. */\n\treadonly failedRuns?: readonly WorkflowRunControlFailedRun[];\n\n\tconstructor(code: WorkflowRunControlErrorCode, message: string, options: WorkflowRunControlErrorOptions = {}) {\n\t\tsuper(message, options);\n\t\tthis.name = \"WorkflowRunControlError\";\n\t\tthis.code = code;\n\t\tif (options.runId !== undefined) this.runId = options.runId;\n\t\tif (options.failedRuns !== undefined) this.failedRuns = options.failedRuns;\n\t}\n}\n\n/** The run id is unknown, malformed, or an ambiguous prefix. */\nexport class WorkflowRunNotFoundError extends WorkflowRunControlError {\n\tconstructor(message: string, options?: WorkflowRunControlErrorOptions) {\n\t\tsuper(\"WORKFLOW_RUN_NOT_FOUND\", message, options);\n\t\tthis.name = \"WorkflowRunNotFoundError\";\n\t}\n}\n\n/** The run belongs to another session or is executing in another live Atomic process. */\nexport class WorkflowRunOwnershipError extends WorkflowRunControlError {\n\tconstructor(message: string, options?: WorkflowRunControlErrorOptions) {\n\t\tsuper(\"WORKFLOW_RUN_OWNED_ELSEWHERE\", message, options);\n\t\tthis.name = \"WorkflowRunOwnershipError\";\n\t}\n}\n\n/** The run has no continuation to resume: it completed, was killed, or has no durable progress. */\nexport class WorkflowRunNotResumableError extends WorkflowRunControlError {\n\tconstructor(message: string, options?: WorkflowRunControlErrorOptions) {\n\t\tsuper(\"WORKFLOW_RUN_NOT_RESUMABLE\", message, options);\n\t\tthis.name = \"WorkflowRunNotResumableError\";\n\t}\n}\n\n/** The stage identifier matches no stage or tool node of the run. */\nexport class WorkflowStageNotFoundError extends WorkflowRunControlError {\n\tconstructor(message: string, options?: WorkflowRunControlErrorOptions) {\n\t\tsuper(\"WORKFLOW_STAGE_NOT_FOUND\", message, options);\n\t\tthis.name = \"WorkflowStageNotFoundError\";\n\t}\n}\n\n/** The stage identifier matches more than one stage or tool node; pass a more specific identifier. */\nexport class WorkflowStageAmbiguousError extends WorkflowRunControlError {\n\tconstructor(message: string, options?: WorkflowRunControlErrorOptions) {\n\t\tsuper(\"WORKFLOW_STAGE_AMBIGUOUS\", message, options);\n\t\tthis.name = \"WorkflowStageAmbiguousError\";\n\t}\n}\n\n/** A durable run can only be resumed whole; resume it without a stage identifier. */\nexport class WorkflowStageResumeUnsupportedError extends WorkflowRunControlError {\n\tconstructor(message: string, options?: WorkflowRunControlErrorOptions) {\n\t\tsuper(\"WORKFLOW_STAGE_RESUME_UNSUPPORTED\", message, options);\n\t\tthis.name = \"WorkflowStageResumeUnsupportedError\";\n\t}\n}\n\n/** Workflow durability (the run database) is unavailable, shut down, or failed. */\nexport class WorkflowRunDatabaseError extends WorkflowRunControlError {\n\tconstructor(message: string, options?: WorkflowRunControlErrorOptions) {\n\t\tsuper(\"WORKFLOW_RUN_DATABASE\", message, options);\n\t\tthis.name = \"WorkflowRunDatabaseError\";\n\t}\n}\n\n/** The workflows extension is not loaded for this session, or the session was disposed. */\nexport class WorkflowRunControlUnavailableError extends WorkflowRunControlError {\n\tconstructor(\n\t\tmessage = \"Workflow run control is unavailable for this session.\",\n\t\toptions?: WorkflowRunControlErrorOptions,\n\t) {\n\t\tsuper(\"WORKFLOW_RUN_CONTROL_UNAVAILABLE\", message, options);\n\t\tthis.name = \"WorkflowRunControlUnavailableError\";\n\t}\n}\n"]}

package/dist/core/mcp-child-policy.d.ts

@@ -0,0 +1,11 @@
+import type { ToolDefinition } from "./extensions/tool-types.ts";
+import type { RegisteredTool, SubagentChildPolicy } from "./extensions/types.ts";
+export interface NativeMcpToolIdentity {
+    readonly server: string;
+    readonly tool: string;
+}
+export declare function markNativeMcpToolDefinition(definition: ToolDefinition, identity: NativeMcpToolIdentity): void;
+export declare function getNativeMcpToolIdentity(definition: ToolDefinition): NativeMcpToolIdentity | undefined;
+export declare function matchesMcpDirectToolSelection(selections: readonly string[], server: string, tool: string): boolean;
+export declare function isSelectedNativeMcpTool(registration: RegisteredTool, policy: SubagentChildPolicy | undefined): boolean;
+//# sourceMappingURL=mcp-child-policy.d.ts.map

package/dist/core/mcp-child-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-child-policy.d.ts","sourceRoot":"","sources":["../../src/core/mcp-child-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAID,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAE7G;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,cAAc,GAAG,qBAAqB,GAAG,SAAS,CAEtG;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOlH;AAED,wBAAgB,uBAAuB,CACtC,YAAY,EAAE,cAAc,EAC5B,MAAM,EAAE,mBAAmB,GAAG,SAAS,GACrC,OAAO,CAUT"}

package/dist/core/mcp-child-policy.js

@@ -0,0 +1,31 @@
+import { getBuiltinExtensionEntryLabel } from "./extensions/builtin-extension-entry-labels.js";
+const nativeToolIdentities = new WeakMap();
+export function markNativeMcpToolDefinition(definition, identity) {
+    nativeToolIdentities.set(definition, identity);
+}
+export function getNativeMcpToolIdentity(definition) {
+    return nativeToolIdentities.get(definition);
+}
+export function matchesMcpDirectToolSelection(selections, server, tool) {
+    return selections.some((selection) => {
+        let end = selection.length;
+        while (end > 0 && selection[end - 1] === "/")
+            end--;
+        const value = selection.slice(0, end);
+        return value === server || value === `${server}/${tool}`;
+    });
+}
+export function isSelectedNativeMcpTool(registration, policy) {
+    if ((policy?.depth ?? 0) < 1 || !policy?.mcpDirectTools?.length)
+        return false;
+    if (registration.definition.exposure === "hidden")
+        return false;
+    const { sourceInfo } = registration;
+    if (sourceInfo.configurationOrigin !== "bundled")
+        return false;
+    if (sourceInfo.path !== "builtin:mcp" && getBuiltinExtensionEntryLabel(sourceInfo.path) !== "mcp")
+        return false;
+    const identity = getNativeMcpToolIdentity(registration.definition);
+    return (identity !== undefined && matchesMcpDirectToolSelection(policy.mcpDirectTools, identity.server, identity.tool));
+}
+//# sourceMappingURL=mcp-child-policy.js.map

package/dist/core/mcp-child-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-child-policy.js","sourceRoot":"","sources":["../../src/core/mcp-child-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,gDAAgD,CAAC;AAS/F,MAAM,oBAAoB,GAAG,IAAI,OAAO,EAAyC,CAAC;AAElF,MAAM,UAAU,2BAA2B,CAAC,UAA0B,EAAE,QAA+B;IACtG,oBAAoB,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,UAA0B;IAClE,OAAO,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,UAA6B,EAAE,MAAc,EAAE,IAAY;IACxG,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QACpC,IAAI,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;QAC3B,OAAO,GAAG,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG;YAAE,GAAG,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACtC,YAA4B,EAC5B,MAAuC;IAEvC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM;QAAE,OAAO,KAAK,CAAC;IAC9E,IAAI,YAAY,CAAC,UAAU,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,EAAE,UAAU,EAAE,GAAG,YAAY,CAAC;IACpC,IAAI,UAAU,CAAC,mBAAmB,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC/D,IAAI,UAAU,CAAC,IAAI,KAAK,aAAa,IAAI,6BAA6B,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAChH,MAAM,QAAQ,GAAG,wBAAwB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACnE,OAAO,CACN,QAAQ,KAAK,SAAS,IAAI,6BAA6B,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAC9G,CAAC;AACH,CAAC","sourcesContent":["import { getBuiltinExtensionEntryLabel } from \"./extensions/builtin-extension-entry-labels.ts\";\nimport type { ToolDefinition } from \"./extensions/tool-types.ts\";\nimport type { RegisteredTool, SubagentChildPolicy } from \"./extensions/types.ts\";\n\nexport interface NativeMcpToolIdentity {\n\treadonly server: string;\n\treadonly tool: string;\n}\n\nconst nativeToolIdentities = new WeakMap<ToolDefinition, NativeMcpToolIdentity>();\n\nexport function markNativeMcpToolDefinition(definition: ToolDefinition, identity: NativeMcpToolIdentity): void {\n\tnativeToolIdentities.set(definition, identity);\n}\n\nexport function getNativeMcpToolIdentity(definition: ToolDefinition): NativeMcpToolIdentity | undefined {\n\treturn nativeToolIdentities.get(definition);\n}\n\nexport function matchesMcpDirectToolSelection(selections: readonly string[], server: string, tool: string): boolean {\n\treturn selections.some((selection) => {\n\t\tlet end = selection.length;\n\t\twhile (end > 0 && selection[end - 1] === \"/\") end--;\n\t\tconst value = selection.slice(0, end);\n\t\treturn value === server || value === `${server}/${tool}`;\n\t});\n}\n\nexport function isSelectedNativeMcpTool(\n\tregistration: RegisteredTool,\n\tpolicy: SubagentChildPolicy | undefined,\n): boolean {\n\tif ((policy?.depth ?? 0) < 1 || !policy?.mcpDirectTools?.length) return false;\n\tif (registration.definition.exposure === \"hidden\") return false;\n\tconst { sourceInfo } = registration;\n\tif (sourceInfo.configurationOrigin !== \"bundled\") return false;\n\tif (sourceInfo.path !== \"builtin:mcp\" && getBuiltinExtensionEntryLabel(sourceInfo.path) !== \"mcp\") return false;\n\tconst identity = getNativeMcpToolIdentity(registration.definition);\n\treturn (\n\t\tidentity !== undefined && matchesMcpDirectToolSelection(policy.mcpDirectTools, identity.server, identity.tool)\n\t);\n}\n"]}

package/dist/core/mcp-servers.d.ts

@@ -1,39 +1,48 @@
 import type { SourceInfo } from "./source-info.ts";
-export interface McpServerOAuthConfig {
-    grantType?: "authorization_code" | "client_credentials";
-    clientId?: string;
-    clientSecret?: string;
-    scope?: string;
+export type McpExposure = "codemode" | "deferred" | "direct" | "hidden";
+interface McpServerConfigBase {
+    exposure?: McpExposure;
+    description?: string;
+    toolExposure?: Record<string, McpExposure>;
+    enabled?: boolean;
+    timeout?: number;
 }
-/** One MCP server definition; the same schema as an `mcpServers` entry in `mcp.json`. */
-export interface McpServerConfig {
-    command?: string;
+export interface McpStdioServerConfig extends McpServerConfigBase {
+    type?: "stdio";
+    command: string;
     args?: string[];
     env?: Record<string, string>;
     cwd?: string;
-    url?: string;
+}
+export interface McpHttpServerConfig extends McpServerConfigBase {
+    type?: "http";
+    url: string;
     headers?: Record<string, string>;
-    auth?: "oauth" | "bearer" | false;
-    bearerToken?: string;
-    bearerTokenEnv?: string;
-    oauth?: McpServerOAuthConfig | false;
-    lifecycle?: "keep-alive" | "lazy" | "eager";
-    idleTimeout?: number;
-    exposeResources?: boolean;
-    directTools?: boolean | string[];
-    excludeTools?: string[];
-    debug?: boolean;
-    timeoutMs?: number;
-    /** Drop the server from the effective MCP configuration. */
-    disabled?: boolean;
+    oauth?: McpOAuthConfig;
+    auth?: {
+        provider: string;
+    };
 }
-/** An MCP server contributed by a package manifest or an extension's `pi.registerMcpServer()` call. */
+export type McpServerConfig = McpStdioServerConfig | McpHttpServerConfig;
 export interface McpServerContribution {
     name: string;
     config: McpServerConfig;
-    /** `package` for manifest `mcpServers`; `extension` for runtime registrations. */
     origin: "package" | "extension";
-    /** Declaring manifest file for packages; registering extension path and its package source for extensions. */
     sourceInfo: SourceInfo;
 }
+export interface McpOAuthConfig {
+    clientId?: string;
+    clientSecret?: string;
+    callbackPort?: number;
+    callbackUrl?: string;
+    scope?: string;
+    clientName?: string;
+    authServerMetadataUrl?: string;
+}
+export declare function mcpNamespace(server: string): string;
+export declare function resolveMcpServerUrl(value: string): string;
+export declare function isLoopbackRedirectUri(value: string): boolean;
+export declare function getMcpToolExposure(config: McpServerConfig, toolName: string): McpExposure;
+export declare function validateMcpServerConfig(name: string, raw: unknown): McpServerConfig | string;
+export {};
 //# sourceMappingURL=mcp-servers.d.ts.map

package/dist/core/mcp-servers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-servers.d.ts","sourceRoot":"","sources":["../../src/core/mcp-servers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACpC,SAAS,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,CAAC;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,yFAAyF;AACzF,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAC;IACrC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,uGAAuG;AACvG,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,kFAAkF;IAClF,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,8GAA8G;IAC9G,UAAU,EAAE,UAAU,CAAC;CACvB"}
+{"version":3,"file":"mcp-servers.d.ts","sourceRoot":"","sources":["../../src/core/mcp-servers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAMxE,UAAU,mBAAmB;IAC5B,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AACD,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5B;AACD,MAAM,MAAM,eAAe,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;AACzE,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;CACvB;AACD,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAOD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAazD;AACD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI5D;AAiDD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAOzF;AACD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,MAAM,CAkD5F"}

package/dist/core/mcp-servers.js

@@ -1,2 +1,149 @@
-export {};
+const MCP_EXPOSURES = ["codemode", "deferred", "direct", "hidden"];
+const EXPOSURE_ALIASES = { "codemode-deferred": "codemode" };
+const LOOPBACK_HOSTS = ["localhost", "127.0.0.1", "[::1]"];
+const SERVER_NAME = /^[A-Za-z0-9_-]+$/;
+export function mcpNamespace(server) {
+    return `mcp__${server.replace(/-/g, "_")}`;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isStringRecord(value) {
+    return isRecord(value) && Object.values(value).every((entry) => typeof entry === "string");
+}
+export function resolveMcpServerUrl(value) {
+    const resolved = value.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}|\$env:([A-Za-z_][A-Za-z0-9_]*)/g, (_match, brace, powershell) => {
+        const name = brace ?? powershell;
+        const replacement = process.env[name];
+        if (replacement === undefined)
+            throw new Error(`MCP server URL environment variable "${name}" is not set`);
+        return replacement;
+    });
+    if (!URL.canParse(resolved) || !/^https?:$/.test(new URL(resolved).protocol))
+        throw new Error("Invalid MCP server URL after environment variable interpolation: expected HTTP(S)");
+    return resolved;
+}
+export function isLoopbackRedirectUri(value) {
+    if (!URL.canParse(value))
+        return false;
+    const url = new URL(value);
+    return url.protocol === "http:" && LOOPBACK_HOSTS.includes(url.hostname) && !url.search && !url.hash;
+}
+function validateOAuth(value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        return "oauth must be an object";
+    for (const key of ["clientId", "clientSecret", "scope"])
+        if (value[key] !== undefined && typeof value[key] !== "string")
+            return `oauth.${key} must be a string`;
+    const port = value.callbackPort;
+    if (port !== undefined && (typeof port !== "number" || !Number.isInteger(port) || port < 1 || port > 65535))
+        return "oauth.callbackPort must be a port number";
+    if (value.callbackUrl !== undefined) {
+        if (typeof value.callbackUrl !== "string" || !isLoopbackRedirectUri(value.callbackUrl))
+            return "oauth.callbackUrl must be an http URI on localhost, 127.0.0.1, or [::1] without query or fragment";
+        const urlPort = new URL(value.callbackUrl).port;
+        if (urlPort && port !== undefined && Number(urlPort) !== port)
+            return "oauth.callbackUrl and oauth.callbackPort name different ports";
+    }
+    if (value.clientName !== undefined && (typeof value.clientName !== "string" || !value.clientName.trim()))
+        return "oauth.clientName must be a non-empty string";
+    const metadataUrl = value.authServerMetadataUrl;
+    if (metadataUrl !== undefined) {
+        const url = typeof metadataUrl === "string" && URL.canParse(metadataUrl) ? new URL(metadataUrl) : undefined;
+        if (!url || !(url.protocol === "https:" || (url.protocol === "http:" && LOOPBACK_HOSTS.includes(url.hostname))))
+            return "oauth.authServerMetadataUrl must be an https URL, or http on localhost, 127.0.0.1, or [::1]";
+    }
+    return undefined;
+}
+function isExposure(value) {
+    return typeof value === "string" && MCP_EXPOSURES.includes(value);
+}
+function resolveExposureAlias(value) {
+    return typeof value === "string" ? (EXPOSURE_ALIASES[value] ?? value) : value;
+}
+function resolveExposureAliases(raw) {
+    const value = { ...raw };
+    if (raw.exposure !== undefined)
+        value.exposure = resolveExposureAlias(raw.exposure);
+    if (isRecord(raw.toolExposure))
+        value.toolExposure = Object.fromEntries(Object.entries(raw.toolExposure).map(([tool, exposure]) => [tool, resolveExposureAlias(exposure)]));
+    return value;
+}
+function toolPatternRegExp(pattern) {
+    return new RegExp(`^${pattern
+        .split("*")
+        .map((part) => part.replace(/[.+?^${}()|[\]\\]/g, "\\$&"))
+        .join(".*")}$`);
+}
+export function getMcpToolExposure(config, toolName) {
+    const overrides = config.toolExposure ?? {};
+    const exact = overrides[toolName];
+    if (exact !== undefined)
+        return exact;
+    for (const [pattern, exposure] of Object.entries(overrides))
+        if (pattern.includes("*") && toolPatternRegExp(pattern).test(toolName))
+            return exposure;
+    return config.exposure ?? "codemode";
+}
+export function validateMcpServerConfig(name, raw) {
+    if (!SERVER_NAME.test(name))
+        return `invalid server name "${name}" (use letters, digits, "_" and "-")`;
+    if (!isRecord(raw))
+        return `server "${name}" must be an object`;
+    const value = resolveExposureAliases(raw);
+    const { type, exposure, enabled, timeout, toolExposure, description } = value;
+    const exposures = MCP_EXPOSURES.map((entry) => `"${entry}"`).join(", ");
+    if (exposure !== undefined && !isExposure(exposure))
+        return `server "${name}": exposure must be one of ${exposures}`;
+    if (toolExposure !== undefined) {
+        if (!isRecord(toolExposure))
+            return `server "${name}": toolExposure must map tool names to exposures`;
+        for (const [tool, entry] of Object.entries(toolExposure))
+            if (!isExposure(entry))
+                return `server "${name}": toolExposure "${tool}" must be one of ${exposures}`;
+    }
+    if (enabled !== undefined && typeof enabled !== "boolean")
+        return `server "${name}": enabled must be a boolean`;
+    if (description !== undefined && typeof description !== "string")
+        return `server "${name}": description must be a string`;
+    if (timeout !== undefined && (typeof timeout !== "number" || !(timeout > 0)))
+        return `server "${name}": timeout must be a positive number of seconds`;
+    if (type === "sse")
+        return `server "${name}": legacy SSE transport is not supported; use the streamable HTTP URL`;
+    if (typeof value.url === "string" && (type === undefined || type === "http" || type === "streamable-http")) {
+        let resolvedUrl;
+        try {
+            resolvedUrl = resolveMcpServerUrl(value.url);
+        }
+        catch {
+            return `server "${name}": url must be an http or https URL after environment variable interpolation`;
+        }
+        if (value.headers !== undefined && !isStringRecord(value.headers))
+            return `server "${name}": headers must map names to strings`;
+        const oauthError = validateOAuth(value.oauth);
+        if (oauthError)
+            return `server "${name}": ${oauthError}`;
+        if (value.auth !== undefined) {
+            if (!isRecord(value.auth) || typeof value.auth.provider !== "string" || !value.auth.provider)
+                return `server "${name}": auth.provider must be a provider name`;
+            const url = new URL(resolvedUrl);
+            if (url.protocol !== "https:" && !(url.protocol === "http:" && LOOPBACK_HOSTS.includes(url.hostname)))
+                return `server "${name}": auth requires an https URL, or http on localhost, 127.0.0.1, or [::1]`;
+        }
+        return value;
+    }
+    if (typeof value.command === "string" && (type === undefined || type === "stdio")) {
+        if (value.args !== undefined &&
+            !(Array.isArray(value.args) && value.args.every((arg) => typeof arg === "string")))
+            return `server "${name}": args must be an array of strings`;
+        if (value.env !== undefined && !isStringRecord(value.env))
+            return `server "${name}": env must map names to strings`;
+        if (value.cwd !== undefined && typeof value.cwd !== "string")
+            return `server "${name}": cwd must be a string`;
+        return value;
+    }
+    return `server "${name}" needs either "command" (stdio) or "url" (streamable HTTP)`;
+}
 //# sourceMappingURL=mcp-servers.js.map