@nklisch/pi-enhanced 0.1.0

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-contract.d.ts

@@ -0,0 +1,226 @@
+import { z } from "zod";
+import { type JsonValue } from "../domain/schema.js";
+import { SafeDisplayFieldSchema } from "./native-inspection-contract.js";
+import { type NativeControlCommandId } from "./native-control-registry.js";
+export declare const NativeControlEnvelopeVersionSchema: z.ZodLiteral<1>;
+export declare const NativeControlExecutionIdSchema: z.core.$ZodBranded<z.ZodString, "NativeControlExecutionId", "out">;
+export type NativeControlExecutionId = z.infer<typeof NativeControlExecutionIdSchema>;
+export declare const NativeControlExitRegistry: Readonly<{
+    readonly success: Readonly<{
+        classification: "success";
+        code: 0;
+    }>;
+    readonly usage: Readonly<{
+        classification: "usage";
+        code: 2;
+    }>;
+    readonly inputRequired: Readonly<{
+        classification: "input-required";
+        code: 3;
+    }>;
+    readonly notFound: Readonly<{
+        classification: "not-found";
+        code: 4;
+    }>;
+    readonly conflict: Readonly<{
+        classification: "conflict-or-stale";
+        code: 5;
+    }>;
+    readonly unavailable: Readonly<{
+        classification: "unavailable";
+        code: 6;
+    }>;
+    readonly rejected: Readonly<{
+        classification: "rejected-or-blocked";
+        code: 7;
+    }>;
+    readonly incomplete: Readonly<{
+        classification: "partial-or-recovery-required";
+        code: 8;
+    }>;
+    readonly cancelled: Readonly<{
+        classification: "cancelled-or-timeout";
+        code: 9;
+    }>;
+    readonly internal: Readonly<{
+        classification: "internal";
+        code: 10;
+    }>;
+    readonly delivery: Readonly<{
+        classification: "output-delivery-failed";
+        code: 74;
+    }>;
+}>;
+export type NativeControlExitKey = keyof typeof NativeControlExitRegistry;
+export type NativeControlExit = (typeof NativeControlExitRegistry)[keyof typeof NativeControlExitRegistry];
+export declare const NativeControlExitSchema: z.ZodType<NativeControlExit>;
+export declare const NativeControlStatusSchema: z.ZodEnum<{
+    cancelled: "cancelled";
+    conflict: "conflict";
+    failed: "failed";
+    "input-required": "input-required";
+    "no-change": "no-change";
+    "not-found": "not-found";
+    ok: "ok";
+    partial: "partial";
+    "presentation-required": "presentation-required";
+    "recovery-required": "recovery-required";
+    rejected: "rejected";
+    stale: "stale";
+    unavailable: "unavailable";
+}>;
+export type NativeControlStatus = z.infer<typeof NativeControlStatusSchema>;
+export declare const NativeControlDiagnosticSchema: z.ZodReadonly<z.ZodObject<{
+    code: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warning: "warning";
+    }>;
+    field: z.ZodOptional<z.ZodString>;
+    action: z.ZodEnum<{
+        "confirm-exact": "confirm-exact";
+        none: "none";
+        poll: "poll";
+        "provide-input": "provide-input";
+        refresh: "refresh";
+        reinspect: "reinspect";
+        reparse: "reparse";
+        retry: "retry";
+        "run-recovery": "run-recovery";
+    }>;
+    safe: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        text: z.ZodString;
+        escaped: z.ZodBoolean;
+        truncated: z.ZodBoolean;
+    }, z.core.$strict>>>;
+}, z.core.$strict>>;
+export type NativeControlDiagnostic = z.infer<typeof NativeControlDiagnosticSchema>;
+export declare const NativeControlOperationHandleSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"trusted-install">;
+    token: z.core.$ZodBranded<z.ZodString, "TrustedInstallSessionToken", "out">;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"lifecycle">;
+    token: z.core.$ZodBranded<z.ZodString, "NativeLifecycleOperationToken", "out">;
+}, z.core.$strict>>], "kind">;
+export type NativeControlOperationHandle = z.infer<typeof NativeControlOperationHandleSchema>;
+export declare const NativeControlPageSchema: z.ZodReadonly<z.ZodObject<{
+    next: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+export declare const NativeControlEnvelopeSchema: z.ZodReadonly<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    grammarVersion: z.ZodLiteral<"plugin-control/v1">;
+    executionId: z.core.$ZodBranded<z.ZodString, "NativeControlExecutionId", "out">;
+    command: z.ZodReadonly<z.ZodObject<{
+        id: z.ZodEnum<{
+            browse: "browse";
+            "config.host-precedence": "config.host-precedence";
+            grammar: "grammar";
+            help: "help";
+            "inspection.diagnose": "inspection.diagnose";
+            "inspection.list": "inspection.list";
+            "inspection.show": "inspection.show";
+            "install.apply": "install.apply";
+            "install.open": "install.open";
+            "install.recover": "install.recover";
+            "install.run": "install.run";
+            "lifecycle.disable": "lifecycle.disable";
+            "lifecycle.enable": "lifecycle.enable";
+            "lifecycle.uninstall": "lifecycle.uninstall";
+            "lifecycle.update": "lifecycle.update";
+            "marketplace.add": "marketplace.add";
+            "marketplace.adopt.import": "marketplace.adopt.import";
+            "marketplace.adopt.preview": "marketplace.adopt.preview";
+            "marketplace.list": "marketplace.list";
+            "marketplace.refresh": "marketplace.refresh";
+            "marketplace.remove": "marketplace.remove";
+            "operation.cancel": "operation.cancel";
+            "operation.status": "operation.status";
+            presentation: "presentation";
+            "project.sync": "project.sync";
+            status: "status";
+            "updates.automatic.run": "updates.automatic.run";
+            "updates.notices.acknowledge": "updates.notices.acknowledge";
+            "updates.notices.list": "updates.notices.list";
+            "updates.policy.apply": "updates.policy.apply";
+            "updates.policy.preview": "updates.policy.preview";
+            "updates.policy.set": "updates.policy.set";
+            "updates.status": "updates.status";
+        }>;
+        path: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        conflict: "conflict";
+        failed: "failed";
+        "input-required": "input-required";
+        "no-change": "no-change";
+        "not-found": "not-found";
+        ok: "ok";
+        partial: "partial";
+        "presentation-required": "presentation-required";
+        "recovery-required": "recovery-required";
+        rejected: "rejected";
+        stale: "stale";
+        unavailable: "unavailable";
+    }>;
+    exit: z.ZodType<NativeControlExit, unknown, z.core.$ZodTypeInternals<NativeControlExit, unknown>>;
+    data: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    operation: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"trusted-install">;
+        token: z.core.$ZodBranded<z.ZodString, "TrustedInstallSessionToken", "out">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"lifecycle">;
+        token: z.core.$ZodBranded<z.ZodString, "NativeLifecycleOperationToken", "out">;
+    }, z.core.$strict>>], "kind">>;
+    page: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        next: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    diagnostics: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        code: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        field: z.ZodOptional<z.ZodString>;
+        action: z.ZodEnum<{
+            "confirm-exact": "confirm-exact";
+            none: "none";
+            poll: "poll";
+            "provide-input": "provide-input";
+            refresh: "refresh";
+            reinspect: "reinspect";
+            reparse: "reparse";
+            retry: "retry";
+            "run-recovery": "run-recovery";
+        }>;
+        safe: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+            text: z.ZodString;
+            escaped: z.ZodBoolean;
+            truncated: z.ZodBoolean;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>>;
+    human: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        text: z.ZodString;
+        escaped: z.ZodBoolean;
+        truncated: z.ZodBoolean;
+    }, z.core.$strict>>>>;
+}, z.core.$strict>>;
+export type NativeControlEnvelope = z.infer<typeof NativeControlEnvelopeSchema>;
+export declare function nativeControlExit(key: NativeControlExitKey): NativeControlExit;
+export declare function nativeControlStatusExit(status: NativeControlStatus): NativeControlExit;
+export declare function createNativeControlEnvelope(input: Readonly<{
+    executionId: NativeControlExecutionId;
+    command: NativeControlCommandId;
+    status: NativeControlStatus;
+    data?: JsonValue;
+    operation?: NativeControlOperationHandle;
+    page?: Readonly<{
+        next?: string;
+    }>;
+    diagnostics?: readonly NativeControlDiagnostic[];
+    human?: readonly z.infer<typeof SafeDisplayFieldSchema>[];
+    usageFailure?: boolean;
+    exitOverride?: NativeControlExit;
+}>): NativeControlEnvelope;

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-contract.js

@@ -0,0 +1,140 @@
+import { z } from "zod";
+import { JsonValueSchema } from "../domain/schema.js";
+import { SafeDisplayFieldSchema } from "./native-inspection-contract.js";
+import { NativeLifecycleOperationTokenSchema } from "./native-lifecycle-operation-contract.js";
+import { NativeControlCommandIdSchema, NativeControlCommandRegistry, NativeControlGrammarVersionSchema, } from "./native-control-registry.js";
+import { TrustedInstallSessionTokenSchema } from "./trusted-install-contract.js";
+export const NativeControlEnvelopeVersionSchema = z.literal(1);
+export const NativeControlExecutionIdSchema = z.string()
+    .regex(/^native-control-execution-v1:[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/)
+    .brand();
+export const NativeControlExitRegistry = Object.freeze({
+    success: Object.freeze({ classification: "success", code: 0 }),
+    usage: Object.freeze({ classification: "usage", code: 2 }),
+    inputRequired: Object.freeze({ classification: "input-required", code: 3 }),
+    notFound: Object.freeze({ classification: "not-found", code: 4 }),
+    conflict: Object.freeze({ classification: "conflict-or-stale", code: 5 }),
+    unavailable: Object.freeze({ classification: "unavailable", code: 6 }),
+    rejected: Object.freeze({ classification: "rejected-or-blocked", code: 7 }),
+    incomplete: Object.freeze({ classification: "partial-or-recovery-required", code: 8 }),
+    cancelled: Object.freeze({ classification: "cancelled-or-timeout", code: 9 }),
+    internal: Object.freeze({ classification: "internal", code: 10 }),
+    delivery: Object.freeze({ classification: "output-delivery-failed", code: 74 }),
+});
+const exitSchemas = Object.values(NativeControlExitRegistry).map((entry) => z.object({
+    classification: z.literal(entry.classification),
+    code: z.literal(entry.code),
+}).strict().readonly());
+export const NativeControlExitSchema = z.union(exitSchemas);
+export const NativeControlStatusSchema = z.enum([
+    "ok", "no-change", "input-required", "not-found", "stale", "conflict",
+    "unavailable", "rejected", "partial", "recovery-required", "cancelled",
+    "failed", "presentation-required",
+]);
+export const NativeControlDiagnosticSchema = z.object({
+    code: z.string().regex(/^[A-Z][A-Z0-9_]{0,63}$/),
+    severity: z.enum(["info", "warning", "error"]),
+    field: z.string().regex(/^[a-z][a-zA-Z0-9.\[\]-]*$/).optional(),
+    action: z.enum(["retry", "reparse", "provide-input", "confirm-exact", "refresh", "reinspect", "poll", "run-recovery", "none"]),
+    safe: SafeDisplayFieldSchema.optional(),
+}).strict().readonly();
+export const NativeControlOperationHandleSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("trusted-install"), token: TrustedInstallSessionTokenSchema }).strict().readonly(),
+    z.object({ kind: z.literal("lifecycle"), token: NativeLifecycleOperationTokenSchema }).strict().readonly(),
+]);
+export const NativeControlPageSchema = z.object({ next: z.string().min(1).max(4096).optional() }).strict().readonly();
+const statusExit = Object.freeze({
+    ok: "success",
+    "no-change": "success",
+    "input-required": "inputRequired",
+    "not-found": "notFound",
+    stale: "conflict",
+    conflict: "conflict",
+    unavailable: "unavailable",
+    rejected: "rejected",
+    partial: "incomplete",
+    "recovery-required": "incomplete",
+    cancelled: "cancelled",
+    failed: "internal",
+    "presentation-required": "success",
+});
+export const NativeControlEnvelopeSchema = z.object({
+    schemaVersion: NativeControlEnvelopeVersionSchema,
+    grammarVersion: NativeControlGrammarVersionSchema,
+    executionId: NativeControlExecutionIdSchema,
+    command: z.object({
+        id: NativeControlCommandIdSchema,
+        path: z.array(z.string().regex(/^[a-z][a-z0-9-]*$/)).max(8).readonly(),
+    }).strict().readonly(),
+    status: NativeControlStatusSchema,
+    exit: NativeControlExitSchema,
+    data: JsonValueSchema.optional(),
+    operation: NativeControlOperationHandleSchema.optional(),
+    page: NativeControlPageSchema.optional(),
+    diagnostics: z.array(NativeControlDiagnosticSchema).max(512).readonly(),
+    human: z.array(SafeDisplayFieldSchema).max(512).readonly(),
+}).strict().readonly().superRefine((envelope, context) => {
+    const definition = NativeControlCommandRegistry[envelope.command.id];
+    if (envelope.command.path.join("\0") !== definition.path.join("\0")) {
+        context.addIssue({ code: "custom", path: ["command", "path"], message: "envelope command path is not canonical" });
+    }
+    const expected = NativeControlExitRegistry[statusExit[envelope.status]];
+    if (envelope.status === "failed" && envelope.exit.classification === "usage") {
+        // Parse/usage failures deliberately use failed + usage.
+    }
+    else if (envelope.status === "presentation-required" && envelope.exit.classification === "input-required") {
+        // A headless no-arg invocation retains presentation intent while reporting
+        // that a UI/input provider is required.
+    }
+    else if (envelope.exit.classification !== expected.classification || envelope.exit.code !== expected.code) {
+        context.addIssue({ code: "custom", path: ["exit"], message: "status and exit classification disagree" });
+    }
+    if (envelope.operation !== undefined && !["ok", "input-required", "partial", "recovery-required"].includes(envelope.status)) {
+        context.addIssue({ code: "custom", path: ["operation"], message: "operation handle is not valid for this status" });
+    }
+    if (envelope.page !== undefined && envelope.data === undefined) {
+        context.addIssue({ code: "custom", path: ["page"], message: "page metadata requires data" });
+    }
+    if (envelope.data !== undefined) {
+        const projected = definition.projectedResponse.safeParse(envelope.data);
+        if (!projected.success) {
+            context.addIssue({ code: "custom", path: ["data"], message: "envelope data does not match the command projection schema" });
+        }
+    }
+});
+export function nativeControlExit(key) {
+    return NativeControlExitSchema.parse(NativeControlExitRegistry[key]);
+}
+export function nativeControlStatusExit(status) {
+    return nativeControlExit(statusExit[status]);
+}
+export function createNativeControlEnvelope(input) {
+    const definition = NativeControlCommandRegistry[input.command];
+    return NativeControlEnvelopeSchema.parse({
+        schemaVersion: 1,
+        grammarVersion: "plugin-control/v1",
+        executionId: input.executionId,
+        command: { id: input.command, path: definition.path },
+        status: input.status,
+        exit: input.exitOverride ?? (input.usageFailure ? NativeControlExitRegistry.usage : nativeControlStatusExit(input.status)),
+        ...(input.data === undefined ? {} : { data: input.data }),
+        ...(input.operation === undefined ? {} : { operation: input.operation }),
+        ...(input.page === undefined ? {} : { page: input.page }),
+        diagnostics: input.diagnostics ?? [],
+        human: input.human ?? [],
+    });
+}
+function validateExitRegistry() {
+    const classifications = new Set();
+    const codes = new Set();
+    for (const entry of Object.values(NativeControlExitRegistry)) {
+        if (classifications.has(entry.classification) || codes.has(entry.code))
+            throw new Error("native control exits must be unique");
+        if (!Number.isInteger(entry.code) || entry.code < 0 || entry.code > 125)
+            throw new Error("native control exit code is outside the portable process range");
+        classifications.add(entry.classification);
+        codes.add(entry.code);
+    }
+}
+validateExitRegistry();
+//# sourceMappingURL=native-control-contract.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-contract.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-dispatcher.d.ts

@@ -0,0 +1,30 @@
+import type { NativeControlDispatchContext } from "./ports/native-control-applications.js";
+import type { NativeControlCommand, NativeControlCommandId } from "./native-control-registry.js";
+import type { NativeControlDispatchResult } from "./native-control-projection.js";
+export type NativeControlHandlerContext = Omit<NativeControlDispatchContext, "readiness"> & Readonly<{
+    readiness?: NativeControlDispatchContext["readiness"];
+}>;
+export type NativeControlCommandHandler<K extends NativeControlCommandId> = (command: Extract<NativeControlCommand, {
+    command: K;
+}>, context: NativeControlHandlerContext, signal: AbortSignal) => Promise<NativeControlDispatchResult>;
+/** Every grammar command must have exactly one dispatch owner. */
+export type NativeControlHandlerMap = Readonly<{
+    [K in NativeControlCommandId]: NativeControlCommandHandler<K>;
+}>;
+type ReadDispatcher = Readonly<{
+    dispatch(command: NativeControlCommand, signal: AbortSignal): Promise<NativeControlDispatchResult | undefined>;
+}>;
+type MutationDispatcher = Readonly<{
+    dispatch(command: NativeControlCommand, context: NativeControlDispatchContext, signal: AbortSignal): Promise<NativeControlDispatchResult | undefined>;
+}>;
+/**
+ * The exhaustive map is the routing authority. Read/mutation dispatchers own
+ * workflow assembly only; adding a registry command fails typecheck here until
+ * one owner is selected.
+ */
+export declare function createNativeControlHandlerMap(input: Readonly<{
+    read: ReadDispatcher;
+    mutation: MutationDispatcher;
+}>): NativeControlHandlerMap;
+export declare function dispatchNativeControlCommand(handlers: NativeControlHandlerMap, command: NativeControlCommand, context: NativeControlHandlerContext, signal: AbortSignal): Promise<NativeControlDispatchResult>;
+export {};

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-dispatcher.js

@@ -0,0 +1,63 @@
+async function required(result, owner) {
+    const value = await result;
+    if (value === undefined)
+        throw new TypeError(`native control ${owner} handler rejected its registered command`);
+    return value;
+}
+/**
+ * The exhaustive map is the routing authority. Read/mutation dispatchers own
+ * workflow assembly only; adding a registry command fails typecheck here until
+ * one owner is selected.
+ */
+export function createNativeControlHandlerMap(input) {
+    const read = (command, _context, signal) => required(input.read.dispatch(command, signal), "read");
+    const mutation = (command, context, signal) => {
+        if (context.readiness === undefined)
+            throw new TypeError("native control mutation handler requires readiness admission");
+        return required(input.mutation.dispatch(command, context, signal), "mutation");
+    };
+    const handlers = {
+        presentation: read,
+        help: read,
+        grammar: read,
+        "marketplace.add": mutation,
+        "marketplace.remove": mutation,
+        "marketplace.list": read,
+        "marketplace.refresh": mutation,
+        "marketplace.adopt.preview": read,
+        "marketplace.adopt.import": mutation,
+        browse: read,
+        "inspection.list": read,
+        "inspection.show": read,
+        "inspection.diagnose": read,
+        "install.open": mutation,
+        "install.apply": mutation,
+        "install.recover": mutation,
+        "install.run": mutation,
+        "lifecycle.enable": mutation,
+        "lifecycle.disable": mutation,
+        "lifecycle.update": mutation,
+        "lifecycle.uninstall": mutation,
+        "project.sync": mutation,
+        "updates.status": read,
+        "updates.policy.preview": read,
+        "updates.policy.apply": mutation,
+        "updates.policy.set": mutation,
+        "updates.notices.list": read,
+        "updates.notices.acknowledge": mutation,
+        "updates.automatic.run": mutation,
+        "config.host-precedence": mutation,
+        status: read,
+        "operation.status": read,
+        "operation.cancel": read,
+    };
+    return Object.freeze(handlers);
+}
+export function dispatchNativeControlCommand(handlers, command, context, signal) {
+    // The key and discriminant are correlated by NativeControlHandlerMap. The
+    // cast is local to this dispatcher because TypeScript cannot preserve that
+    // correlation through computed property access.
+    const handler = handlers[command.command];
+    return handler(command, context, signal);
+}
+//# sourceMappingURL=native-control-dispatcher.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-control-dispatcher.js","sourceRoot":"","sources":["../../src/application/native-control-dispatcher.ts"],"names":[],"mappings":"AAyBA,KAAK,UAAU,QAAQ,CAAC,MAAwD,EAAE,KAA0B;IAC1G,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,kBAAkB,KAAK,0CAA0C,CAAC,CAAC;IAChH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAG5C;IACA,MAAM,IAAI,GAAG,CAAmC,OAAsD,EAAE,QAAqC,EAAE,MAAmB,EAAE,EAAE,CACpK,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,CAAmC,OAAsD,EAAE,OAAoC,EAAE,MAAmB,EAAE,EAAE;QACvK,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAAC;QACzH,OAAO,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAuC,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;IACjH,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,QAAQ;QAC3B,oBAAoB,EAAE,QAAQ;QAC9B,kBAAkB,EAAE,IAAI;QACxB,qBAAqB,EAAE,QAAQ;QAC/B,2BAA2B,EAAE,IAAI;QACjC,0BAA0B,EAAE,QAAQ;QACpC,MAAM,EAAE,IAAI;QACZ,iBAAiB,EAAE,IAAI;QACvB,iBAAiB,EAAE,IAAI;QACvB,qBAAqB,EAAE,IAAI;QAC3B,cAAc,EAAE,QAAQ;QACxB,eAAe,EAAE,QAAQ;QACzB,iBAAiB,EAAE,QAAQ;QAC3B,aAAa,EAAE,QAAQ;QACvB,kBAAkB,EAAE,QAAQ;QAC5B,mBAAmB,EAAE,QAAQ;QAC7B,kBAAkB,EAAE,QAAQ;QAC5B,qBAAqB,EAAE,QAAQ;QAC/B,cAAc,EAAE,QAAQ;QACxB,gBAAgB,EAAE,IAAI;QACtB,wBAAwB,EAAE,IAAI;QAC9B,sBAAsB,EAAE,QAAQ;QAChC,oBAAoB,EAAE,QAAQ;QAC9B,sBAAsB,EAAE,IAAI;QAC5B,6BAA6B,EAAE,QAAQ;QACvC,uBAAuB,EAAE,QAAQ;QACjC,wBAAwB,EAAE,QAAQ;QAClC,MAAM,EAAE,IAAI;QACZ,kBAAkB,EAAE,IAAI;QACxB,kBAAkB,EAAE,IAAI;KACS,CAAC;IACpC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAAiC,EACjC,OAA6B,EAC7B,OAAoC,EACpC,MAAmB;IAEnB,0EAA0E;IAC1E,2EAA2E;IAC3E,gDAAgD;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAwD,CAAC;IACjG,OAAO,OAAO,CAAC,OAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-error.d.ts

@@ -0,0 +1,7 @@
+import type { NativeControlStatus } from "./native-control-contract.js";
+export type NativeControlErrorClassification = Readonly<{
+    status: NativeControlStatus;
+    code: string;
+    action: "retry" | "reparse" | "provide-input" | "confirm-exact" | "refresh" | "reinspect" | "poll" | "run-recovery" | "none";
+}>;
+export declare function classifyNativeControlError(error: unknown): NativeControlErrorClassification;

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-error.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+function stableCode(error) {
+    if (error === null || typeof error !== "object" || !("code" in error))
+        return undefined;
+    const code = error.code;
+    return typeof code === "string" && /^[A-Z][A-Z0-9_]{0,63}$/.test(code) ? code : undefined;
+}
+export function classifyNativeControlError(error) {
+    if (error !== null && typeof error === "object" && "code" in error && error.code === "CONTROL_QUIESCED")
+        return { status: "rejected", code: "CONTROL_QUIESCED", action: "retry" };
+    if (error instanceof z.ZodError)
+        return { status: "failed", code: "CONTROL_CONTRACT_INVALID", action: "none" };
+    if (error !== null && typeof error === "object" && "name" in error && error.name === "AbortError") {
+        return { status: "cancelled", code: "CONTROL_CANCELLED", action: "retry" };
+    }
+    const code = stableCode(error);
+    if (code === undefined)
+        return { status: "failed", code: "CONTROL_INTERNAL", action: "none" };
+    if (code.includes("CURSOR_STALE") || code.includes("STATE_STALE") || code.includes("PREVIEW_STALE") || code.includes("SESSION_STALE"))
+        return { status: "stale", code, action: "reinspect" };
+    if (code.includes("CURSOR_INVALID") || code.includes("INVALID_REQUEST") || code.includes("QUERY_INVALID"))
+        return { status: "failed", code, action: "reparse" };
+    if (code.includes("NOT_FOUND") || code.includes("MISSING") || code.includes("EXPIRED") || code.includes("DISPOSED"))
+        return { status: "not-found", code, action: "reinspect" };
+    if (code.includes("UNAVAILABLE") || code.includes("ADAPTER_FAILED") || code.includes("OFFLINE"))
+        return { status: "unavailable", code, action: "retry" };
+    if (code.includes("PROJECT_UNTRUSTED") || code.includes("INCOMPATIBLE") || code.includes("REJECTED") || code.includes("BLOCKED"))
+        return { status: "rejected", code, action: "none" };
+    if (code.includes("RECOVERY") || code.includes("AMBIGUOUS") || code.includes("ROLLBACK") || code.includes("CLEANUP_FAILED"))
+        return { status: "recovery-required", code, action: "run-recovery" };
+    if (code.includes("ABORT"))
+        return { status: "cancelled", code, action: "retry" };
+    return { status: "failed", code: "CONTROL_INTERNAL", action: "none" };
+}
+//# sourceMappingURL=native-control-error.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-error.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-execution.d.ts

@@ -0,0 +1,20 @@
+import { type NativeControlCommand } from "./native-control-registry.js";
+import type { NativeControlDispatchExecutionContext, NativeControlExecutionCoreOptions, NativeControlExecutionIdPort, NativeControlExecutionReport, NativeControlTimeoutPort } from "./ports/native-control-execution.js";
+import type { NativeControlDispatchResult } from "./native-control-projection.js";
+import { type NativeControlResultProjector } from "./native-control-result.js";
+export declare class NativeControlAdmissionError extends Error {
+    readonly code = "CONTROL_QUIESCED";
+    constructor();
+}
+export type NativeControlDispatchFunction = (command: NativeControlCommand, context: NativeControlDispatchExecutionContext, signal: AbortSignal) => Promise<NativeControlDispatchResult>;
+export interface NativeControlExecutionCoordinator {
+    execute(command: NativeControlCommand, options: NativeControlExecutionCoreOptions, dispatch: NativeControlDispatchFunction, signal: AbortSignal): Promise<NativeControlExecutionReport>;
+    quiesce(): void;
+    close(): Promise<void>;
+    activeCount(): number;
+}
+export declare function createNativeControlExecutionCoordinator(dependencies: Readonly<{
+    ids: NativeControlExecutionIdPort;
+    timeouts: NativeControlTimeoutPort;
+    results?: NativeControlResultProjector;
+}>): NativeControlExecutionCoordinator;

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-execution.js

@@ -0,0 +1,83 @@
+import { NativeControlCommandSchema } from "./native-control-registry.js";
+import { createNativeControlProgressController } from "./native-control-progress.js";
+import { createNativeControlResultProjector } from "./native-control-result.js";
+export class NativeControlAdmissionError extends Error {
+    code = "CONTROL_QUIESCED";
+    constructor() {
+        super("native control service is quiesced");
+        this.name = "NativeControlAdmissionError";
+    }
+}
+function operationSignal(parent) {
+    const controller = new AbortController();
+    const abort = () => controller.abort(parent.reason);
+    if (parent.aborted)
+        abort();
+    else
+        parent.addEventListener("abort", abort, { once: true });
+    return Object.freeze({ controller, dispose: () => parent.removeEventListener("abort", abort) });
+}
+export function createNativeControlExecutionCoordinator(dependencies) {
+    const results = dependencies.results ?? createNativeControlResultProjector();
+    let accepting = true;
+    let closePromise;
+    const active = new Set();
+    async function executeAdmitted(commandInput, options, dispatch, callerSignal) {
+        const command = NativeControlCommandSchema.parse(commandInput);
+        callerSignal.throwIfAborted();
+        const executionId = await dependencies.ids.issue(callerSignal);
+        const timeout = options.timeoutMs === undefined ? undefined : dependencies.timeouts.arm(options.timeoutMs, callerSignal);
+        const linked = operationSignal(timeout?.signal ?? callerSignal);
+        // Operation cancellation and output delivery are separate concerns. A
+        // timeout/SIGINT aborts owner work but must not pre-abort the terminal
+        // cancelled envelope that explains the numeric exit to the caller.
+        const delivery = new AbortController();
+        const progress = createNativeControlProgressController({
+            executionId,
+            command: command.command,
+            ...(options.sink === undefined ? {} : { sink: options.sink }),
+            signal: delivery.signal,
+            abortDelivery: () => linked.controller.abort(new Error("native control output delivery failed")),
+        });
+        let envelope;
+        try {
+            await progress.accepted();
+            try {
+                const result = await dispatch(command, { executionId, command: command.command, progress: progress.progress }, linked.controller.signal);
+                envelope = results.project(command, result, executionId);
+            }
+            catch (error) {
+                const classified = linked.controller.signal.aborted || callerSignal.aborted || timeout?.signal.aborted === true
+                    ? new DOMException("native control execution cancelled", "AbortError")
+                    : error;
+                envelope = results.classifyError(command, classified, executionId);
+            }
+            await progress.result(envelope);
+        }
+        finally {
+            timeout?.dispose();
+            linked.dispose();
+            await progress.close();
+        }
+        return Object.freeze({ envelope, delivery: progress.delivery(), deliveredThrough: progress.deliveredThrough() });
+    }
+    const coordinator = {
+        execute(command, options, dispatch, signal) {
+            if (!accepting)
+                return Promise.reject(new NativeControlAdmissionError());
+            const promise = executeAdmitted(command, options, dispatch, signal);
+            active.add(promise);
+            void promise.finally(() => active.delete(promise)).catch(() => undefined);
+            return promise;
+        },
+        quiesce() { accepting = false; },
+        close() {
+            accepting = false;
+            closePromise ??= Promise.allSettled([...active]).then(() => undefined);
+            return closePromise;
+        },
+        activeCount: () => active.size,
+    };
+    return Object.freeze(coordinator);
+}
+//# sourceMappingURL=native-control-execution.js.map