pi-subagents 0.69.0 → 0.70.0

package/src/shared/workflow-child-permit.d.ts

@@ -0,0 +1,59 @@
+import type { WorkflowResourceProvenance } from "./types.ts";
+export interface WorkflowChildPermitInput {
+    issuerPackage: string;
+    workflowRunId: string;
+    childKey: string;
+    agent: string;
+    launchContractDigest: string;
+    context: "fresh" | "fork";
+}
+export interface WorkflowChildPermitLaunch {
+    workflowRunId: string;
+    childKey: string;
+    agent: string;
+    launchContractDigest: string;
+    context: "fresh" | "fork";
+    runner: "pi";
+}
+export interface WorkflowChildPermitContext {
+    permit: WorkflowChildPermit;
+    workflowRunId: string;
+    childKey: string;
+}
+export interface WorkflowChildPermit {
+    readonly __workflowChildPermit: unique symbol;
+}
+/** Package-internal first-slice permit. It is opaque, in-memory, and not serializable. */
+export declare function createWorkflowChildPermit(input: WorkflowChildPermitInput): WorkflowChildPermit;
+export declare function validateWorkflowChildPermitRoot(permit: WorkflowChildPermit, workflowRunId: string): string | undefined;
+/** Claim the first distinct launch attempt before validating its model-authored shape. */
+export declare function claimWorkflowChildPermit(permit: WorkflowChildPermit, workflowRunId: string, childKey: string): string | undefined;
+/** Verify and permanently consume the permit before the one native process spawn. */
+export declare function consumeWorkflowChildPermit(permit: WorkflowChildPermit, launch: WorkflowChildPermitLaunch): string | undefined;
+export declare function workflowChildPermitConsumed(permit: WorkflowChildPermit): boolean;
+export interface WorkflowResourceHostAuthority {
+    key: string;
+    command: string;
+}
+export interface WorkflowResourceAuthority {
+    host?: readonly WorkflowResourceHostAuthority[];
+}
+export interface WorkflowResourcePermitInput {
+    resourceName: string;
+    resourceVersion: number;
+    resourceId: string;
+    scriptDigest: string;
+    authority: WorkflowResourceAuthority;
+}
+export interface WorkflowResourcePermit {
+    readonly __workflowResourcePermit: unique symbol;
+}
+/** Package-internal permit for a workflow resource resolved by the extension. */
+export declare function createWorkflowResourcePermit(input: WorkflowResourcePermitInput): WorkflowResourcePermit;
+export declare function consumeWorkflowResourcePermit(permit: WorkflowResourcePermit, script: string): {
+    provenance: WorkflowResourceProvenance;
+    authority: WorkflowResourceAuthority;
+} | string;
+/** Validate a host call against the authority attached to a consumed resource. */
+export declare function authorizeWorkflowResourceHost(permit: WorkflowResourcePermit, key: string, command: string): string | undefined;
+//# sourceMappingURL=workflow-child-permit.d.ts.map

package/src/shared/workflow-child-permit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-child-permit.d.ts","sourceRoot":"","sources":["../../../src/shared/workflow-child-permit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,wBAAwB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,0BAA0B;IAC1C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,MAAM,CAAC;CAC9C;AA6BD,0FAA0F;AAC1F,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,wBAAwB,GAAG,mBAAmB,CAkB9F;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMtH;AAED,0FAA0F;AAC1F,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQjI;AAED,qFAAqF;AACrF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,yBAAyB,GAAG,MAAM,GAAG,SAAS,CAY7H;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAGhF;AAED,MAAM,WAAW,6BAA6B;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACzC,IAAI,CAAC,EAAE,SAAS,6BAA6B,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,2BAA2B;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,yBAAyB,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,wBAAwB,EAAE,OAAO,MAAM,CAAC;CACjD;AA8BD,iFAAiF;AACjF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,2BAA2B,GAAG,sBAAsB,CAwBvG;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,0BAA0B,CAAC;IAAC,SAAS,EAAE,yBAAyB,CAAA;CAAE,GAAG,MAAM,CAOvL;AAED,kFAAkF;AAClF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO9H"}

package/src/shared/workflow-child-permit.js

@@ -0,0 +1,160 @@
+import { stableJsonDigest } from "./launch-contract.js";
+const records = new WeakMap();
+function projectionDigest(input) {
+    return stableJsonDigest({
+        version: 1,
+        childKey: input.childKey,
+        agent: input.agent,
+        launchContractDigest: input.launchContractDigest,
+        context: input.context,
+        runner: input.runner,
+    });
+}
+function required(value, label) {
+    if (!value.trim() || value !== value.trim())
+        throw new Error(`${label} must be a non-empty trimmed string.`);
+    return value;
+}
+/** Package-internal first-slice permit. It is opaque, in-memory, and not serializable. */
+export function createWorkflowChildPermit(input) {
+    const permit = Object.freeze(Object.create(null));
+    const record = {
+        issuerPackage: required(input.issuerPackage, "issuerPackage"),
+        workflowRunId: required(input.workflowRunId, "workflowRunId"),
+        childKey: required(input.childKey, "childKey"),
+        agent: required(input.agent, "agent"),
+        expectedProjectionDigest: projectionDigest({
+            childKey: input.childKey,
+            agent: input.agent,
+            launchContractDigest: required(input.launchContractDigest, "launchContractDigest"),
+            context: input.context,
+            runner: "pi",
+        }),
+        state: "available",
+    };
+    records.set(permit, record);
+    return permit;
+}
+export function validateWorkflowChildPermitRoot(permit, workflowRunId) {
+    const record = records.get(permit);
+    if (!record)
+        return "Workflow child permit is invalid.";
+    if (record.state !== "available")
+        return "Workflow child permit is already consumed.";
+    if (record.workflowRunId !== workflowRunId)
+        return "Workflow child permit does not match this workflow root.";
+    return undefined;
+}
+/** Claim the first distinct launch attempt before validating its model-authored shape. */
+export function claimWorkflowChildPermit(permit, workflowRunId, childKey) {
+    const record = records.get(permit);
+    if (!record)
+        return "Workflow child permit is invalid.";
+    if (record.state !== "available")
+        return "Workflow child permit is already consumed.";
+    if (record.workflowRunId !== workflowRunId)
+        return "Workflow child permit does not match this workflow root.";
+    record.state = record.childKey === childKey ? "claimed" : "consumed";
+    if (record.childKey !== childKey)
+        return "Workflow child permit child key mismatch.";
+    return undefined;
+}
+/** Verify and permanently consume the permit before the one native process spawn. */
+export function consumeWorkflowChildPermit(permit, launch) {
+    const record = records.get(permit);
+    if (!record)
+        return "Workflow child permit is invalid.";
+    if (record.state === "available")
+        return "Workflow child permit launch was not claimed.";
+    if (record.state === "consumed")
+        return "Workflow child permit is already consumed.";
+    if (record.workflowRunId !== launch.workflowRunId)
+        return "Workflow child permit does not match this workflow root.";
+    record.state = "consumed";
+    if (record.childKey !== launch.childKey)
+        return "Workflow child permit child key mismatch.";
+    if (record.agent !== launch.agent)
+        return "Workflow child permit agent mismatch.";
+    if (launch.runner !== "pi")
+        return "Workflow child permit supports native Pi children only.";
+    if (record.expectedProjectionDigest !== projectionDigest(launch))
+        return "Workflow child permit does not match the final launch projection.";
+    return undefined;
+}
+export function workflowChildPermitConsumed(permit) {
+    const state = records.get(permit)?.state;
+    return state === "claimed" || state === "consumed";
+}
+const resourceRecords = new WeakMap();
+function cloneWorkflowResourceAuthority(authority) {
+    if (!authority || typeof authority !== "object" || Array.isArray(authority))
+        throw new Error("Workflow resource authority must be an object.");
+    if (authority.host === undefined)
+        return Object.freeze({});
+    if (!Array.isArray(authority.host) || authority.host.length > 32)
+        throw new Error("Workflow resource host authority must be an array of at most 32 grants.");
+    const keys = new Set();
+    const host = Array.from(authority.host, (grant) => {
+        if (!grant || typeof grant !== "object" || Object.keys(grant).some((field) => field !== "key" && field !== "command"))
+            throw new Error("Workflow resource host grant must contain only key and command.");
+        const { key, command } = grant;
+        if (typeof key !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(key) || keys.has(key))
+            throw new Error("Workflow resource host grant requires a unique safe key.");
+        if (typeof command !== "string" || !command.trim() || Buffer.byteLength(command.trim(), "utf8") > 16 * 1024 || command.includes("\0"))
+            throw new Error("Workflow resource host grant requires a non-empty command of at most 16384 bytes without NUL.");
+        keys.add(key);
+        return Object.freeze({ key, command: command.trim() });
+    });
+    return Object.freeze({ host: Object.freeze(host) });
+}
+/** Package-internal permit for a workflow resource resolved by the extension. */
+export function createWorkflowResourcePermit(input) {
+    const resourceName = required(input.resourceName, "resourceName");
+    const resourceId = required(input.resourceId, "resourceId");
+    const scriptDigest = required(input.scriptDigest, "scriptDigest");
+    if (!Number.isInteger(input.resourceVersion) || input.resourceVersion < 1)
+        throw new Error("resourceVersion must be a positive integer.");
+    const authority = cloneWorkflowResourceAuthority(input.authority);
+    const permit = Object.freeze(Object.create(null));
+    resourceRecords.set(permit, {
+        resourceName,
+        resourceVersion: input.resourceVersion,
+        resourceId,
+        scriptDigest,
+        authority,
+        provenance: Object.freeze({
+            kind: "workflow",
+            name: resourceName,
+            version: input.resourceVersion,
+            invocation: "named",
+            expansion: "resolved",
+            id: resourceId,
+        }),
+        state: "available",
+    });
+    return permit;
+}
+export function consumeWorkflowResourcePermit(permit, script) {
+    const record = resourceRecords.get(permit);
+    if (!record)
+        return "Workflow resource permit is invalid.";
+    if (record.state !== "available")
+        return "Workflow resource permit is already consumed.";
+    if (stableJsonDigest(script) !== record.scriptDigest)
+        return "Workflow resource permit does not match the resolved workflow script.";
+    record.state = "consumed";
+    return { provenance: record.provenance, authority: record.authority };
+}
+/** Validate a host call against the authority attached to a consumed resource. */
+export function authorizeWorkflowResourceHost(permit, key, command) {
+    const record = resourceRecords.get(permit);
+    if (!record || record.state !== "consumed")
+        return "Workflow resource authority is unavailable.";
+    const host = record.authority.host;
+    if (!host)
+        return "runs.host is not allowed for this workflow resource.";
+    if (!host.some((grant) => grant.key === key && grant.command === command.trim()))
+        return `The command for runs.host('${key}') is not allowed for workflow resource '${record.resourceName}'.`;
+    return undefined;
+}
+//# sourceMappingURL=workflow-child-permit.js.map

package/src/shared/workflow-child-permit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-child-permit.js","sourceRoot":"","sources":["../../../src/shared/workflow-child-permit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAwCxD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAqC,CAAC;AAEjE,SAAS,gBAAgB,CAAC,KAAuD;IAChF,OAAO,gBAAgB,CAAC;QACvB,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM;KACpB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,KAAa;IAC7C,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,sCAAsC,CAAC,CAAC;IAC7G,OAAO,KAAK,CAAC;AACd,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,yBAAyB,CAAC,KAA+B;IACxE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAwB,CAAC;IACzE,MAAM,MAAM,GAA8B;QACzC,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,eAAe,CAAC;QAC7D,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,eAAe,CAAC;QAC7D,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC9C,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC;QACrC,wBAAwB,EAAE,gBAAgB,CAAC;YAC1C,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,oBAAoB,EAAE,QAAQ,CAAC,KAAK,CAAC,oBAAoB,EAAE,sBAAsB,CAAC;YAClF,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,IAAI;SACZ,CAAC;QACF,KAAK,EAAE,WAAW;KAClB,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,MAAgB,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,MAA2B,EAAE,aAAqB;IACjG,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM;QAAE,OAAO,mCAAmC,CAAC;IACxD,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW;QAAE,OAAO,4CAA4C,CAAC;IACtF,IAAI,MAAM,CAAC,aAAa,KAAK,aAAa;QAAE,OAAO,0DAA0D,CAAC;IAC9G,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,wBAAwB,CAAC,MAA2B,EAAE,aAAqB,EAAE,QAAgB;IAC5G,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM;QAAE,OAAO,mCAAmC,CAAC;IACxD,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW;QAAE,OAAO,4CAA4C,CAAC;IACtF,IAAI,MAAM,CAAC,aAAa,KAAK,aAAa;QAAE,OAAO,0DAA0D,CAAC;IAC9G,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IACrE,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,2CAA2C,CAAC;IACrF,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,0BAA0B,CAAC,MAA2B,EAAE,MAAiC;IACxG,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM;QAAE,OAAO,mCAAmC,CAAC;IACxD,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW;QAAE,OAAO,+CAA+C,CAAC;IACzF,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU;QAAE,OAAO,4CAA4C,CAAC;IACrF,IAAI,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa;QAAE,OAAO,0DAA0D,CAAC;IACrH,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC;IAC1B,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;QAAE,OAAO,2CAA2C,CAAC;IAC5F,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK;QAAE,OAAO,uCAAuC,CAAC;IAClF,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,yDAAyD,CAAC;IAC7F,IAAI,MAAM,CAAC,wBAAwB,KAAK,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,mEAAmE,CAAC;IAC7I,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAA2B;IACtE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAgB,CAAC,EAAE,KAAK,CAAC;IACnD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,CAAC;AACpD,CAAC;AAiCD,MAAM,eAAe,GAAG,IAAI,OAAO,EAAwC,CAAC;AAE5E,SAAS,8BAA8B,CAAC,SAAoC;IAC3E,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAC/I,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7J,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;QACjD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,SAAS,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QAC1M,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QAC/B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC7K,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;QACxP,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,4BAA4B,CAAC,KAAkC;IAC9E,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAClE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC1I,MAAM,SAAS,GAAG,8BAA8B,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAA2B,CAAC;IAC5E,eAAe,CAAC,GAAG,CAAC,MAAgB,EAAE;QACrC,YAAY;QACZ,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,UAAU;QACV,YAAY;QACZ,SAAS;QACT,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,KAAK,CAAC,eAAe;YAC9B,UAAU,EAAE,OAAO;YACnB,SAAS,EAAE,UAAU;YACrB,EAAE,EAAE,UAAU;SACd,CAAC;QACF,KAAK,EAAE,WAAW;KAClB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA8B,EAAE,MAAc;IAC3F,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM;QAAE,OAAO,sCAAsC,CAAC;IAC3D,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW;QAAE,OAAO,+CAA+C,CAAC;IACzF,IAAI,gBAAgB,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,YAAY;QAAE,OAAO,uEAAuE,CAAC;IACrI,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC;IAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;AACvE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,6BAA6B,CAAC,MAA8B,EAAE,GAAW,EAAE,OAAe;IACzG,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU;QAAE,OAAO,6CAA6C,CAAC;IACjG,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,sDAAsD,CAAC;IACzE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,8BAA8B,GAAG,4CAA4C,MAAM,CAAC,YAAY,IAAI,CAAC;IAC9L,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/src/slash/delegation-adapters.d.ts

@@ -0,0 +1,147 @@
+import { type SubagentDelegationRequest, type SubagentDelegationResponse, type SubagentDelegationThinking, type SubagentDelegationUpdate } from "../api/delegation.ts";
+import type { AcceptanceInput, AgentContract, EffectsProjection, ExecutionProjection, IntercomBridgeConfig, JsonSchemaObject, ReviewProjection, ToolBudgetConfig, Usage } from "../shared/types.ts";
+export interface PromptTemplateDelegationRequest {
+    requestId: string;
+    agent: string;
+    task: string;
+    context: "fresh" | "fork";
+    model: string;
+    cwd: string;
+}
+export interface PromptTemplateDelegationResponse extends PromptTemplateDelegationRequest {
+    messages: unknown[];
+    contentText?: string;
+    isError: boolean;
+    errorText?: string;
+}
+interface PromptTemplateDelegationTaskProgress {
+    index?: number;
+    agent: string;
+    status?: string;
+    currentTool?: string;
+    currentToolArgs?: string;
+    recentOutput?: string;
+    recentOutputLines?: string[];
+    recentTools?: Array<{
+        tool: string;
+        args: string;
+    }>;
+    model?: string;
+    toolCount?: number;
+    durationMs?: number;
+    tokens?: number;
+}
+export interface PromptTemplateDelegationUpdate {
+    requestId: string;
+    runId?: string;
+    currentTool?: string;
+    currentToolArgs?: string;
+    recentOutput?: string;
+    recentOutputLines?: string[];
+    recentTools?: Array<{
+        tool: string;
+        args: string;
+    }>;
+    model?: string;
+    toolCount?: number;
+    durationMs?: number;
+    tokens?: number;
+    taskProgress?: PromptTemplateDelegationTaskProgress[];
+}
+interface DelegationAcceptanceSnapshot {
+    status: string;
+    evidenceStatus?: string;
+    explicit?: boolean;
+}
+export interface PromptTemplateBridgeResult {
+    isError?: boolean;
+    content?: unknown;
+    details?: {
+        mode?: "single" | "parallel" | "chain" | "workflow" | "management";
+        runId?: string;
+        timedOut?: boolean;
+        stopped?: boolean;
+        results?: Array<{
+            agent?: string;
+            messages?: unknown[];
+            finalOutput?: string;
+            toolCalls?: Array<{
+                text?: string;
+                expandedText?: string;
+            }>;
+            exitCode?: number;
+            error?: string;
+            model?: string;
+            thinking?: string;
+            structuredOutput?: unknown;
+            interrupted?: boolean;
+            timedOut?: boolean;
+            stopped?: boolean;
+            toolBudgetBlocked?: boolean;
+            structuredOutputFailed?: boolean;
+            savedOutputPath?: string;
+            sessionFile?: string;
+            agentContract?: AgentContract;
+            execution?: ExecutionProjection;
+            acceptance?: DelegationAcceptanceSnapshot;
+            review?: ReviewProjection;
+            effects?: EffectsProjection;
+            usage?: Usage;
+            progressSummary?: {
+                toolCount?: number;
+                durationMs?: number;
+                tokens?: number;
+            };
+            skillsWarning?: string;
+            outputSaveError?: string;
+            transcriptError?: string;
+        }>;
+        progress?: Array<{
+            index?: number;
+            agent?: string;
+            status?: string;
+            currentTool?: string;
+            currentToolArgs?: string;
+            recentOutput?: string[];
+            recentTools?: Array<{
+                tool?: string;
+                args?: string;
+            }>;
+            toolCount?: number;
+            durationMs?: number;
+            tokens?: number;
+        }>;
+    };
+}
+export interface DelegatedSubagentExecutionParams {
+    agent?: string;
+    task?: string;
+    context: "fresh" | "fork";
+    model?: string;
+    cwd: string;
+    timeoutMs?: number;
+    toolBudget?: ToolBudgetConfig;
+    skill?: string | string[] | boolean;
+    output?: string | boolean;
+    outputMode?: "inline" | "file-only";
+    outputSchema?: JsonSchemaObject;
+    agentContract?: AgentContract;
+    acceptance?: AcceptanceInput;
+    artifacts?: boolean;
+    intercomBridge?: IntercomBridgeConfig;
+    /** Internal-only thinking override accepted by executeDelegated. */
+    delegatedThinkingOverride?: SubagentDelegationThinking;
+    /** Internal-only capability accepted and stripped by executeDelegated. */
+    delegatedAllowZeroToolBudget?: true;
+    async: false;
+    foregroundOnly: true;
+    clarify: false;
+}
+export declare function parsePromptTemplateRequest(data: unknown): PromptTemplateDelegationRequest | undefined;
+export declare function toDelegationUpdate(requestId: string, update: PromptTemplateBridgeResult): PromptTemplateDelegationUpdate | undefined;
+export declare function toSubagentDelegationExecutionParams(request: SubagentDelegationRequest): DelegatedSubagentExecutionParams;
+export declare function toSubagentDelegationUpdate(request: SubagentDelegationRequest, result: PromptTemplateBridgeResult): SubagentDelegationUpdate | undefined;
+export declare function toSubagentDelegationResponse(request: SubagentDelegationRequest, result: PromptTemplateBridgeResult, aborted: boolean): SubagentDelegationResponse;
+export declare function toPromptTemplateResponse(request: PromptTemplateDelegationRequest, result: PromptTemplateBridgeResult): PromptTemplateDelegationResponse;
+export {};
+//# sourceMappingURL=delegation-adapters.d.ts.map

package/src/slash/delegation-adapters.d.ts.map

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