@nklisch/pi-enhanced 0.1.0

package/node_modules/@nklisch/pi-plugins/dist/runtime/skills/resource-discovery.js

@@ -0,0 +1,263 @@
+import { createContentIndex, } from "../../application/content-index.js";
+import { ComponentIdSchema, SkillComponentSchema, } from "../../domain/components.js";
+import { normalizeContentPath, } from "../../domain/content-manifest.js";
+import { composeSkillHookContributionObservation, digestSkillResourceContribution, SkillResourceContributionObservationSchema, } from "./contribution-observation.js";
+import {} from "../skill-hook/lifecycle-participant.js";
+import { hasSameCurrentProject, runtimeTargetKey, } from "../skill-hook/runtime-catalog.js";
+function compareCodePoint(left, right) {
+    const leftPoints = [...left];
+    const rightPoints = [...right];
+    const length = Math.min(leftPoints.length, rightPoints.length);
+    for (let index = 0; index < length; index += 1) {
+        const leftPoint = leftPoints[index].codePointAt(0);
+        const rightPoint = rightPoints[index].codePointAt(0);
+        if (leftPoint !== rightPoint)
+            return leftPoint < rightPoint ? -1 : 1;
+    }
+    return leftPoints.length - rightPoints.length;
+}
+function compareScope(left, right) {
+    if (left.kind !== right.kind)
+        return left.kind === "user" ? -1 : 1;
+    if (left.kind === "project" && right.kind === "project")
+        return compareCodePoint(left.projectKey, right.projectKey);
+    return 0;
+}
+function compareSnapshots(left, right) {
+    return compareScope(left.scope, right.scope) || compareCodePoint(left.plugin, right.plugin);
+}
+function compareSkills(left, right) {
+    return compareCodePoint(left.id, right.id) || compareCodePoint(left.root.value, right.root.value);
+}
+function mapTargetFailure(scope, plugin, code) {
+    return Object.freeze({ scope, plugin, code });
+}
+function isAbort(error, signal) {
+    return signal.aborted || (error !== null && typeof error === "object" && "name" in error && error.name === "AbortError");
+}
+function skillFilePath(component) {
+    if (component.root.value === ".")
+        return "SKILL.md";
+    const root = normalizeContentPath(component.root.value);
+    return `${root}/SKILL.md`;
+}
+function manifestEntry(index, component) {
+    let path;
+    try {
+        path = skillFilePath(component);
+    }
+    catch (error) {
+        throw Object.assign(new Error("skill root is unsafe"), { code: "ROOT_ESCAPE", cause: error });
+    }
+    const entry = index.get(path);
+    if (entry === undefined)
+        throw Object.assign(new Error("skill document is absent from the content manifest"), { code: "ROOT_MISSING" });
+    if (entry.kind === "symlink")
+        throw Object.assign(new Error("skill document is a manifest symlink"), { code: "ROOT_ESCAPE" });
+    if (entry.kind !== "file")
+        throw Object.assign(new Error("skill document is not a regular manifest file"), { code: "ROOT_MUTATED" });
+    return entry;
+}
+function pathFailure(error) {
+    if (error !== null && typeof error === "object" && "code" in error) {
+        const code = error.code;
+        if (code === "ROOT_MISSING" || code === "ROOT_ESCAPE" || code === "ROOT_MUTATED" || code === "ROOT_UNREADABLE" || code === "ADAPTER_FAILED")
+            return code;
+    }
+    return "ADAPTER_FAILED";
+}
+function makeResourceObservation(snapshot, ids, digest) {
+    return SkillResourceContributionObservationSchema.parse({
+        kind: "active",
+        participant: "skill-resources",
+        scope: snapshot.scope,
+        plugin: snapshot.plugin,
+        revision: snapshot.revision,
+        projectionDigest: snapshot.projectionDigest,
+        currentProject: snapshot.currentProject,
+        contributionDigest: digest,
+        skillComponentIds: ids,
+    });
+}
+export function createSkillResourceDiscoveryRuntime(dependencies) {
+    if (dependencies === null || typeof dependencies !== "object")
+        throw new TypeError("skill resource discovery dependencies are required");
+    let registry = Object.freeze({ initialized: false, targets: new Map(), failures: new Map() });
+    function invalidate() {
+        registry = Object.freeze({ initialized: false, targets: new Map(), failures: new Map() });
+    }
+    async function discover(request, signal) {
+        try {
+            if (signal.aborted)
+                return { kind: "cancelled" };
+            const snapshots = dependencies.catalog.list();
+            const currentProject = dependencies.catalog.currentProject();
+            if (currentProject === undefined)
+                return { kind: "failed", code: "CATALOG_UNINITIALIZED" };
+            for (const snapshot of snapshots) {
+                if (!hasSameCurrentProject(snapshot.currentProject, currentProject))
+                    return { kind: "failed", code: "CURRENT_PROJECT_MISMATCH" };
+            }
+            const ordered = [...snapshots].sort(compareSnapshots);
+            const targets = new Map();
+            const failures = new Map();
+            const verified = [];
+            for (const snapshot of ordered) {
+                if (signal.aborted)
+                    return { kind: "cancelled" };
+                const key = runtimeTargetKey(snapshot.scope, snapshot.plugin);
+                if (snapshot.scope.kind === "project") {
+                    if (snapshot.scope.projectKey !== currentProject.projectKey) {
+                        failures.set(key, mapTargetFailure(snapshot.scope, snapshot.plugin, "PROJECT_IDENTITY_MISMATCH"));
+                        continue;
+                    }
+                    if (!request.projectTrusted || currentProject.trust.kind !== "trusted") {
+                        failures.set(key, mapTargetFailure(snapshot.scope, snapshot.plugin, "PROJECT_UNTRUSTED"));
+                        continue;
+                    }
+                }
+                const index = createContentIndex(snapshot.content.manifest);
+                const skillPaths = [];
+                let targetFailure;
+                const skills = [...snapshot.skills].map((value) => SkillComponentSchema.parse(value)).sort(compareSkills);
+                for (const skill of skills) {
+                    if (signal.aborted)
+                        return { kind: "cancelled" };
+                    try {
+                        const entry = manifestEntry(index, skill);
+                        const result = await dependencies.paths.verify({ root: snapshot.content.root, entry }, signal);
+                        if (result.kind === "cancelled")
+                            return { kind: "cancelled" };
+                        if (result.kind !== "ready") {
+                            targetFailure = result.code;
+                            break;
+                        }
+                        skillPaths.push(result.value);
+                    }
+                    catch (error) {
+                        if (isAbort(error, signal))
+                            return { kind: "cancelled" };
+                        targetFailure = pathFailure(error);
+                        break;
+                    }
+                }
+                if (targetFailure !== undefined) {
+                    failures.set(key, mapTargetFailure(snapshot.scope, snapshot.plugin, targetFailure));
+                }
+                else {
+                    verified.push({ snapshot, paths: Object.freeze(skillPaths) });
+                }
+            }
+            if (signal.aborted)
+                return { kind: "cancelled" };
+            const emitted = [];
+            const emittedCanonical = new Set();
+            for (const item of verified) {
+                const skills = [...item.snapshot.skills].sort(compareSkills);
+                const ids = skills.map((skill) => ComponentIdSchema.parse(skill.id));
+                const logicalRoots = skills.map((skill) => ({ id: ComponentIdSchema.parse(skill.id), root: skill.root.value }));
+                const digest = digestSkillResourceContribution({
+                    scope: item.snapshot.scope,
+                    plugin: item.snapshot.plugin,
+                    revision: item.snapshot.revision,
+                    projectionDigest: item.snapshot.projectionDigest,
+                    sourceContributionDigest: item.snapshot.contributionDigest,
+                    skills: logicalRoots,
+                }, dependencies.sha256);
+                const observation = makeResourceObservation(item.snapshot, ids, digest);
+                for (const path of item.paths) {
+                    if (!emittedCanonical.has(path.canonicalPath)) {
+                        emittedCanonical.add(path.canonicalPath);
+                        emitted.push(path.path);
+                    }
+                }
+                targets.set(runtimeTargetKey(item.snapshot.scope, item.snapshot.plugin), Object.freeze({
+                    scope: item.snapshot.scope,
+                    plugin: item.snapshot.plugin,
+                    observation,
+                }));
+            }
+            // Registry replacement is one synchronous assignment after every target
+            // has been verified. Cancellation cannot expose a partial path set.
+            if (signal.aborted)
+                return { kind: "cancelled" };
+            registry = Object.freeze({
+                initialized: true,
+                catalogSnapshot: snapshots,
+                targets,
+                failures,
+            });
+            return Object.freeze({ kind: "ready", skillPaths: Object.freeze(emitted), failedTargets: Object.freeze([...failures.values()]) });
+        }
+        catch (error) {
+            if (isAbort(error, signal))
+                return { kind: "cancelled" };
+            return { kind: "failed", code: "ADAPTER_FAILED" };
+        }
+    }
+    async function observe(expectation, signal) {
+        try {
+            if (signal.aborted)
+                return { kind: "cancelled" };
+            const sourceResult = await dependencies.snapshots.observe(expectation, signal);
+            if (sourceResult.kind !== "ready")
+                return sourceResult;
+            if (!registry.initialized || registry.catalogSnapshot !== dependencies.catalog.list())
+                return { kind: "failed", code: "CATALOG_UNINITIALIZED" };
+            const source = sourceResult.observation;
+            const key = runtimeTargetKey(source.scope, source.plugin);
+            if (registry.failures.has(key))
+                return { kind: "failed", code: "RESOURCE_UNAVAILABLE" };
+            const target = registry.targets.get(key);
+            if (source.kind === "active") {
+                if (target === undefined || target.observation.kind !== "active")
+                    return { kind: "failed", code: "OBSERVATION_MISMATCH" };
+                return {
+                    kind: "ready",
+                    observation: composeSkillHookContributionObservation({
+                        expectation,
+                        snapshot: source,
+                        resources: target.observation,
+                        sha256: dependencies.sha256,
+                    }),
+                };
+            }
+            if (target !== undefined)
+                return { kind: "failed", code: "OBSERVATION_MISMATCH" };
+            const inactive = SkillResourceContributionObservationSchema.parse({
+                kind: "inactive",
+                participant: "skill-resources",
+                scope: source.scope,
+                plugin: source.plugin,
+                projectionDigest: source.projectionDigest,
+                currentProject: source.currentProject,
+                contributionDigest: digestSkillResourceContribution({
+                    scope: source.scope,
+                    plugin: source.plugin,
+                    projectionDigest: source.projectionDigest,
+                    sourceContributionDigest: source.contributionDigest,
+                    skills: [],
+                }, dependencies.sha256),
+                skillComponentIds: [],
+            });
+            return {
+                kind: "ready",
+                observation: composeSkillHookContributionObservation({ expectation, snapshot: source, resources: inactive, sha256: dependencies.sha256 }),
+            };
+        }
+        catch (error) {
+            if (isAbort(error, signal))
+                return { kind: "cancelled" };
+            return { kind: "failed", code: "ADAPTER_FAILED" };
+        }
+    }
+    async function reconcile(request, signal) {
+        const result = await dependencies.snapshots.reconcile(request, signal);
+        if (result.kind === "applied")
+            invalidate();
+        return result;
+    }
+    const participant = Object.freeze({ reconcile, observe });
+    return Object.freeze({ participant, resources: Object.freeze({ discover }) });
+}
+//# sourceMappingURL=resource-discovery.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/skills/resource-discovery.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/runtime/subagents/pi-subagents-lifecycle.d.ts

@@ -0,0 +1,12 @@
+import type { SubagentsService } from "@nklisch/pi-subagents";
+import { type SubagentLifecyclePort } from "../../application/ports/subagent-lifecycle.js";
+/**
+ * Translate the documented root export of the qualifying published package.
+ * This is the sole production package boundary: host code sees only its own
+ * port and never a manager, session, record, queue, or package decision type.
+ */
+export declare function createPiSubagentsLifecyclePort(input: Readonly<{
+    service: Pick<SubagentsService, "registerLifecycleInterceptor">;
+}>): SubagentLifecyclePort;
+/** Resolve the selected package through its receipt-gated documented root export only. */
+export declare function createPublishedPiSubagentsLifecyclePort(): Promise<SubagentLifecyclePort | undefined>;

package/node_modules/@nklisch/pi-plugins/dist/runtime/subagents/pi-subagents-lifecycle.js

@@ -0,0 +1,353 @@
+import { loadVerifiedPiSubagentsService } from "./pi-subagents-package.js";
+import { SUBAGENT_LIFECYCLE_CAPABILITY_ID, SUBAGENT_LIFECYCLE_CONFORMANCE_SUITE_VERSION, SUBAGENT_LIFECYCLE_CONTRACT_VERSION, SubagentCompletionDecisionSchemaV1, SubagentExecutionIdentitySchemaV1, SubagentExecutionPathSchemaV1, SubagentLifecycleCapabilitiesSchemaV1, SubagentLifecycleRegistrationEvidenceSchemaV1, SubagentStartDecisionSchemaV1, } from "../../application/ports/subagent-lifecycle.js";
+import { BoundaryError, ErrorCodeRegistry } from "../../domain/errors.js";
+const PACKAGE_NAME = "@nklisch/pi-subagents";
+const PACKAGE_VERSION = "18.0.4-nklisch.0";
+const PACKAGE_INTEGRITY = "sha512-33Q8JDffXUuiT1M3XjLXCI4If9p+3AOwsUp/b5f1+B7Y5JI8Z8SVU+Dncq0umAG2IjgVYKnT9FHToFHNoZGWoQ==";
+const PACKAGE_RELEASE_TAG = "pi-subagents-v18.0.4-nklisch.0";
+const PACKAGE_COMMIT = "43efffb459f64e2f5f9aaee50d8ae5afa564f4f3";
+const PACKAGE_NODE_ENGINE = ">=22";
+const PACKAGE_PI_PEER_RANGE = ">=0.75.0";
+const PACKAGE_CONTINUATION_BUDGET = 3;
+// This digest covers the three unchanged portable conformance vectors: the
+// reusable trace contract, its negative controls, and its port integration.
+const CONFORMANCE_SUITE_DIGEST = "sha256:10166fbb0d775c52a69e9d97c5cbfe0e7a3e4d73f625d19d00c9b30569ae9e5e";
+// Canonical SHA-256 receipt over the package provenance, contract version, and
+// complete vector manifest (without its self-referential receipt field).
+const QUALIFICATION_DIGEST = "sha256:982e03c31c1b8dcbc96a167bf470df934713a2799565df380e82bfee78e39ed6";
+const COMPLETE_SEMANTICS = {
+    orderedAsync: true,
+    exactStartPrompt: true,
+    startReplacement: true,
+    startAbortBeforePrompt: true,
+    executionCancellation: true,
+    proposedResultBeforeFinalization: true,
+    resultReplacement: true,
+    sameSessionContinuation: true,
+    boundedContinuation: true,
+    typedFailureOrdering: true,
+    idempotentUnregister: true,
+    disposeExactlyOnce: true,
+    unchangedWithoutInterceptors: true,
+};
+const COMPLETE_COVERAGE = {
+    tool: true,
+    service: true,
+    foreground: true,
+    background: true,
+    queued: true,
+    initial: true,
+    resume: true,
+    parentIdentityWhenPresent: true,
+};
+const CAPABILITIES = SubagentLifecycleCapabilitiesSchemaV1.parse({
+    schemaVersion: 1,
+    capabilityId: SUBAGENT_LIFECYCLE_CAPABILITY_ID,
+    contractVersion: SUBAGENT_LIFECYCLE_CONTRACT_VERSION,
+    qualificationDigest: QUALIFICATION_DIGEST,
+    semantics: COMPLETE_SEMANTICS,
+    coverage: COMPLETE_COVERAGE,
+    provider: {
+        kind: "published-package",
+        packageName: PACKAGE_NAME,
+        version: PACKAGE_VERSION,
+        integrity: PACKAGE_INTEGRITY,
+        releaseTag: PACKAGE_RELEASE_TAG,
+        commit: PACKAGE_COMMIT,
+        license: "MIT",
+        nodeEngine: PACKAGE_NODE_ENGINE,
+        piPeerRange: PACKAGE_PI_PEER_RANGE,
+        contractVersion: SUBAGENT_LIFECYCLE_CONTRACT_VERSION,
+        conformance: {
+            suiteVersion: SUBAGENT_LIFECYCLE_CONFORMANCE_SUITE_VERSION,
+            suiteDigest: CONFORMANCE_SUITE_DIGEST,
+            qualificationDigest: QUALIFICATION_DIGEST,
+            vectors: { ...COMPLETE_SEMANTICS, ...COMPLETE_COVERAGE },
+        },
+    },
+});
+function adapterFailure(operation, cause) {
+    return new BoundaryError({
+        code: ErrorCodeRegistry.adapterFailed,
+        operation,
+        message: "Published subagent lifecycle adapter failed",
+        cause,
+    });
+}
+function abortReason(signal) {
+    return signal.reason ?? new DOMException("The operation was aborted", "AbortError");
+}
+function assertAbortSignal(value, label) {
+    if (!(value instanceof AbortSignal)) {
+        throw new TypeError(`${label} must be an AbortSignal`);
+    }
+}
+function assertService(value) {
+    if (value === null ||
+        typeof value !== "object" ||
+        typeof value
+            .registerLifecycleInterceptor !== "function") {
+        throw new TypeError("published subagent lifecycle service is unavailable");
+    }
+}
+function assertRegistrationRequest(request) {
+    if (request === null ||
+        typeof request !== "object" ||
+        typeof request
+            .expectedQualificationDigest !== "string" ||
+        request
+            .expectedQualificationDigest !== QUALIFICATION_DIGEST ||
+        request
+            .maxContinuationRounds !== PACKAGE_CONTINUATION_BUDGET) {
+        throw new TypeError("subagent lifecycle registration does not match the qualification receipt");
+    }
+    const interceptor = request.interceptor;
+    if (interceptor === null ||
+        typeof interceptor !== "object" ||
+        typeof interceptor.beforeStart !==
+            "function" ||
+        typeof interceptor
+            .beforeComplete !== "function") {
+        throw new TypeError("subagent lifecycle registration interceptor is invalid");
+    }
+}
+function awaitWithSignal(value, signal) {
+    if (signal.aborted)
+        return Promise.reject(abortReason(signal));
+    return new Promise((resolve, reject) => {
+        const abort = () => reject(abortReason(signal));
+        signal.addEventListener("abort", abort, { once: true });
+        void value.then((result) => {
+            signal.removeEventListener("abort", abort);
+            if (signal.aborted)
+                reject(abortReason(signal));
+            else
+                resolve(result);
+        }, (error) => {
+            signal.removeEventListener("abort", abort);
+            reject(signal.aborted ? abortReason(signal) : error);
+        });
+    });
+}
+function parseNativeIdentity(value) {
+    if (value === null || typeof value !== "object") {
+        throw new TypeError("published lifecycle identity is invalid");
+    }
+    const identity = value;
+    const allowed = new Set([
+        "agentId",
+        "sessionId",
+        "runId",
+        "agentType",
+        "parentSessionId",
+    ]);
+    if (Object.keys(identity).some((key) => !allowed.has(key))) {
+        throw new TypeError("published lifecycle identity contains unsupported fields");
+    }
+    return SubagentExecutionIdentitySchemaV1.parse({
+        schemaVersion: 1,
+        agentId: identity.agentId,
+        sessionId: identity.sessionId,
+        runId: identity.runId,
+        agentType: identity.agentType,
+        ...(identity.parentSessionId === undefined
+            ? {}
+            : { parentSessionId: identity.parentSessionId }),
+    });
+}
+function parseStartRequest(context) {
+    if (context === null || typeof context !== "object") {
+        throw new TypeError("published lifecycle start context is invalid");
+    }
+    const value = context;
+    assertAbortSignal(value.signal, "published lifecycle start signal");
+    if (typeof value.prompt !== "string") {
+        throw new TypeError("published lifecycle start prompt is invalid");
+    }
+    return Object.freeze({
+        identity: parseNativeIdentity(value.identity),
+        execution: SubagentExecutionPathSchemaV1.parse(value.execution),
+        prompt: value.prompt,
+        signal: value.signal,
+    });
+}
+function parseCompletionRequest(context) {
+    if (context === null || typeof context !== "object") {
+        throw new TypeError("published lifecycle completion context is invalid");
+    }
+    const value = context;
+    assertAbortSignal(value.signal, "published lifecycle completion signal");
+    const continuationRound = value.continuationRound;
+    if (typeof value.proposedResult !== "string" ||
+        (value.outcome !== "completed" &&
+            value.outcome !== "steered" &&
+            value.outcome !== "aborted") ||
+        typeof continuationRound !== "number" ||
+        !Number.isInteger(continuationRound) ||
+        continuationRound < 0 ||
+        value.maxContinuationRounds !== PACKAGE_CONTINUATION_BUDGET) {
+        throw new TypeError("published lifecycle completion context is invalid");
+    }
+    return Object.freeze({
+        identity: parseNativeIdentity(value.identity),
+        execution: SubagentExecutionPathSchemaV1.parse(value.execution),
+        proposedResult: value.proposedResult,
+        outcome: value.outcome,
+        continuationRound,
+        maxContinuationRounds: value.maxContinuationRounds,
+        signal: value.signal,
+    });
+}
+async function beforeStart(interceptor, context) {
+    let request;
+    try {
+        request = parseStartRequest(context);
+        request.signal.throwIfAborted();
+        const decision = SubagentStartDecisionSchemaV1.parse(await awaitWithSignal(interceptor.beforeStart(request), request.signal));
+        request.signal.throwIfAborted();
+        if (decision.action === "abort") {
+            return { action: "abort", reason: decision.reason };
+        }
+        // The package treats an omitted prompt as a true no-op, preserving its
+        // released no-provider bytes/order whenever this aggregate is inactive.
+        return decision.prompt === request.prompt
+            ? undefined
+            : { action: "continue", prompt: decision.prompt };
+    }
+    catch (cause) {
+        if (context.signal instanceof AbortSignal && context.signal.aborted) {
+            throw abortReason(context.signal);
+        }
+        if (cause instanceof BoundaryError)
+            throw cause;
+        throw adapterFailure("piSubagentsLifecycle.beforeStart", cause);
+    }
+}
+async function beforeComplete(interceptor, context) {
+    let request;
+    try {
+        request = parseCompletionRequest(context);
+        request.signal.throwIfAborted();
+        const decision = SubagentCompletionDecisionSchemaV1.parse(await awaitWithSignal(interceptor.beforeComplete(request), request.signal));
+        request.signal.throwIfAborted();
+        if (decision.action === "abort") {
+            return { action: "abort", reason: decision.reason };
+        }
+        if (decision.action === "continue") {
+            if (request.continuationRound >= request.maxContinuationRounds) {
+                return {
+                    action: "abort",
+                    reason: "Subagent lifecycle continuation limit is exhausted",
+                };
+            }
+            return { action: "continue", prompt: decision.prompt };
+        }
+        return decision.result === request.proposedResult
+            ? undefined
+            : { action: "complete", result: decision.result };
+    }
+    catch (cause) {
+        if (context.signal instanceof AbortSignal && context.signal.aborted) {
+            throw abortReason(context.signal);
+        }
+        if (cause instanceof BoundaryError)
+            throw cause;
+        throw adapterFailure("piSubagentsLifecycle.beforeComplete", cause);
+    }
+}
+function nativeInterceptor(interceptor) {
+    return Object.freeze({
+        beforeStart: (context) => beforeStart(interceptor, context),
+        beforeComplete: (context) => beforeComplete(interceptor, context),
+    });
+}
+function parseNativeRegistration(value) {
+    if (value === null ||
+        typeof value !== "object" ||
+        typeof value.dispose !== "function") {
+        throw new TypeError("published subagent lifecycle registration is invalid");
+    }
+    return value;
+}
+/**
+ * Translate the documented root export of the qualifying published package.
+ * This is the sole production package boundary: host code sees only its own
+ * port and never a manager, session, record, queue, or package decision type.
+ */
+export function createPiSubagentsLifecyclePort(input) {
+    try {
+        if (input === null || typeof input !== "object") {
+            throw new TypeError("published subagent lifecycle adapter input is required");
+        }
+        assertService(input.service);
+    }
+    catch (cause) {
+        throw adapterFailure("createPiSubagentsLifecyclePort", cause);
+    }
+    return Object.freeze({
+        async capabilities(signal) {
+            try {
+                assertAbortSignal(signal, "subagent lifecycle capability signal");
+                signal.throwIfAborted();
+                return CAPABILITIES;
+            }
+            catch (cause) {
+                if (signal instanceof AbortSignal && signal.aborted)
+                    throw abortReason(signal);
+                if (cause instanceof BoundaryError)
+                    throw cause;
+                throw adapterFailure("piSubagentsLifecycle.capabilities", cause);
+            }
+        },
+        async register(request, signal) {
+            let native;
+            try {
+                assertAbortSignal(signal, "subagent lifecycle registration signal");
+                signal.throwIfAborted();
+                assertRegistrationRequest(request);
+                native = parseNativeRegistration(input.service.registerLifecycleInterceptor(nativeInterceptor(request.interceptor)));
+                if (signal.aborted) {
+                    await native.dispose();
+                    throw abortReason(signal);
+                }
+            }
+            catch (cause) {
+                if (signal instanceof AbortSignal && signal.aborted)
+                    throw abortReason(signal);
+                if (cause instanceof BoundaryError)
+                    throw cause;
+                throw adapterFailure("piSubagentsLifecycle.register", cause);
+            }
+            let disposePromise;
+            const dispose = () => {
+                disposePromise ??= Promise.resolve().then(async () => {
+                    try {
+                        await native.dispose();
+                    }
+                    catch (cause) {
+                        throw adapterFailure("piSubagentsLifecycle.dispose", cause);
+                    }
+                });
+                return disposePromise;
+            };
+            return Object.freeze({
+                evidence: SubagentLifecycleRegistrationEvidenceSchemaV1.parse({
+                    schemaVersion: 1,
+                    contractVersion: SUBAGENT_LIFECYCLE_CONTRACT_VERSION,
+                    capabilityId: SUBAGENT_LIFECYCLE_CAPABILITY_ID,
+                    qualificationDigest: QUALIFICATION_DIGEST,
+                    orderedAsync: true,
+                    maxContinuationRounds: PACKAGE_CONTINUATION_BUDGET,
+                    state: "registered",
+                }),
+                dispose,
+            });
+        },
+    });
+}
+/** Resolve the selected package through its receipt-gated documented root export only. */
+export async function createPublishedPiSubagentsLifecyclePort() {
+    const service = await loadVerifiedPiSubagentsService();
+    return service === undefined ? undefined : createPiSubagentsLifecyclePort({ service });
+}
+//# sourceMappingURL=pi-subagents-lifecycle.js.map