@claudexor/cli 3.24.0 → 4.0.0

package/dist/model-operation-control.d.ts

@@ -0,0 +1,375 @@
+import type { ModelOperations } from "@claudexor/daemon";
+import type { JobAdmission } from "@claudexor/schema";
+/** Existing model controls, with one synchronous snapshot of this operation's
+ * live admission facts. Provider dispatch and result custody stay in their owner. */
+export declare function modelOperationControlServices(operations: Pick<ModelOperations, "create" | "inspect" | "readResult" | "acknowledge" | "cancel">, admission?: (id: string) => JobAdmission | null): {
+    createModelOperation: (...args: Parameters<ModelOperations["create"]>) => Promise<{
+        id: string;
+        state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+        admission?: {
+            class: "model" | "non_model";
+            phase: "active" | "queued";
+            blockers: ({
+                kind: "global_limit";
+                limit: number;
+            } | {
+                kind: "class_limit";
+                limit: number;
+            } | {
+                kind: "thread_busy";
+            } | {
+                kind: "stopping";
+            })[];
+        } | null | undefined;
+        createdAt: string;
+        startedAt: string | null;
+        finishedAt: string | null;
+        dispatch: {
+            state: "not_started" | "response_received" | "started" | "unknown";
+            startedAt: string | null;
+            route: {
+                source: string;
+                credentialProfileId: string;
+                accountFingerprint: string | null;
+                model: string | null;
+            } | null;
+        };
+        response: {
+            state: "absent";
+        } | {
+            state: "ready";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            readyAt: string;
+            expiresAt: string;
+        } | {
+            state: "acknowledged";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            releasedAt: string;
+        } | {
+            state: "expired";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            releasedAt: string;
+        };
+        usage: {
+            input_tokens: number | null;
+            output_tokens: number | null;
+            cached_input_tokens: number | null;
+            cache_write_tokens: number | null;
+            reasoning_tokens: number | null;
+        };
+        cost: {
+            processing?: {
+                nativeMode: string | null;
+                kind: "cash" | "included" | "paid_credits" | "unknown" | "valuation";
+                source: string;
+            } | undefined;
+            knowledge: "estimated" | "exact" | "unknown";
+            billing: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
+            source: string;
+            provenance: string[];
+            estimatedUsd: number | null;
+            cashUsd: number | null;
+            valuationUsd: number | null;
+            valuationKnowledge: "estimated" | "exact" | "unknown";
+        } | null;
+        problem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors: Record<string, string[]>;
+            requiredActions: string[];
+            evidenceRefs: string[];
+            context: Record<string, unknown>;
+        } | null;
+    }>;
+    getModelOperation: (id: string) => Promise<{
+        id: string;
+        state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+        admission?: {
+            class: "model" | "non_model";
+            phase: "active" | "queued";
+            blockers: ({
+                kind: "global_limit";
+                limit: number;
+            } | {
+                kind: "class_limit";
+                limit: number;
+            } | {
+                kind: "thread_busy";
+            } | {
+                kind: "stopping";
+            })[];
+        } | null | undefined;
+        createdAt: string;
+        startedAt: string | null;
+        finishedAt: string | null;
+        dispatch: {
+            state: "not_started" | "response_received" | "started" | "unknown";
+            startedAt: string | null;
+            route: {
+                source: string;
+                credentialProfileId: string;
+                accountFingerprint: string | null;
+                model: string | null;
+            } | null;
+        };
+        response: {
+            state: "absent";
+        } | {
+            state: "ready";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            readyAt: string;
+            expiresAt: string;
+        } | {
+            state: "acknowledged";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            releasedAt: string;
+        } | {
+            state: "expired";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            releasedAt: string;
+        };
+        usage: {
+            input_tokens: number | null;
+            output_tokens: number | null;
+            cached_input_tokens: number | null;
+            cache_write_tokens: number | null;
+            reasoning_tokens: number | null;
+        };
+        cost: {
+            processing?: {
+                nativeMode: string | null;
+                kind: "cash" | "included" | "paid_credits" | "unknown" | "valuation";
+                source: string;
+            } | undefined;
+            knowledge: "estimated" | "exact" | "unknown";
+            billing: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
+            source: string;
+            provenance: string[];
+            estimatedUsd: number | null;
+            cashUsd: number | null;
+            valuationUsd: number | null;
+            valuationKnowledge: "estimated" | "exact" | "unknown";
+        } | null;
+        problem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors: Record<string, string[]>;
+            requiredActions: string[];
+            evidenceRefs: string[];
+            context: Record<string, unknown>;
+        } | null;
+    }>;
+    readModelResult: (id: string) => Promise<{
+        bytes: Buffer;
+        sha256: string;
+    }>;
+    acknowledgeModelResult: (id: string, sha256: string) => Promise<{
+        id: string;
+        state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+        admission?: {
+            class: "model" | "non_model";
+            phase: "active" | "queued";
+            blockers: ({
+                kind: "global_limit";
+                limit: number;
+            } | {
+                kind: "class_limit";
+                limit: number;
+            } | {
+                kind: "thread_busy";
+            } | {
+                kind: "stopping";
+            })[];
+        } | null | undefined;
+        createdAt: string;
+        startedAt: string | null;
+        finishedAt: string | null;
+        dispatch: {
+            state: "not_started" | "response_received" | "started" | "unknown";
+            startedAt: string | null;
+            route: {
+                source: string;
+                credentialProfileId: string;
+                accountFingerprint: string | null;
+                model: string | null;
+            } | null;
+        };
+        response: {
+            state: "absent";
+        } | {
+            state: "ready";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            readyAt: string;
+            expiresAt: string;
+        } | {
+            state: "acknowledged";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            releasedAt: string;
+        } | {
+            state: "expired";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            releasedAt: string;
+        };
+        usage: {
+            input_tokens: number | null;
+            output_tokens: number | null;
+            cached_input_tokens: number | null;
+            cache_write_tokens: number | null;
+            reasoning_tokens: number | null;
+        };
+        cost: {
+            processing?: {
+                nativeMode: string | null;
+                kind: "cash" | "included" | "paid_credits" | "unknown" | "valuation";
+                source: string;
+            } | undefined;
+            knowledge: "estimated" | "exact" | "unknown";
+            billing: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
+            source: string;
+            provenance: string[];
+            estimatedUsd: number | null;
+            cashUsd: number | null;
+            valuationUsd: number | null;
+            valuationKnowledge: "estimated" | "exact" | "unknown";
+        } | null;
+        problem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors: Record<string, string[]>;
+            requiredActions: string[];
+            evidenceRefs: string[];
+            context: Record<string, unknown>;
+        } | null;
+    }>;
+    cancelModelOperation: (...args: Parameters<ModelOperations["cancel"]>) => Promise<{
+        id: string;
+        state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+        admission?: {
+            class: "model" | "non_model";
+            phase: "active" | "queued";
+            blockers: ({
+                kind: "global_limit";
+                limit: number;
+            } | {
+                kind: "class_limit";
+                limit: number;
+            } | {
+                kind: "thread_busy";
+            } | {
+                kind: "stopping";
+            })[];
+        } | null | undefined;
+        createdAt: string;
+        startedAt: string | null;
+        finishedAt: string | null;
+        dispatch: {
+            state: "not_started" | "response_received" | "started" | "unknown";
+            startedAt: string | null;
+            route: {
+                source: string;
+                credentialProfileId: string;
+                accountFingerprint: string | null;
+                model: string | null;
+            } | null;
+        };
+        response: {
+            state: "absent";
+        } | {
+            state: "ready";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            readyAt: string;
+            expiresAt: string;
+        } | {
+            state: "acknowledged";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            releasedAt: string;
+        } | {
+            state: "expired";
+            ref: {
+                resourceId: string;
+                sha256: string;
+                sizeBytes: number;
+            };
+            releasedAt: string;
+        };
+        usage: {
+            input_tokens: number | null;
+            output_tokens: number | null;
+            cached_input_tokens: number | null;
+            cache_write_tokens: number | null;
+            reasoning_tokens: number | null;
+        };
+        cost: {
+            processing?: {
+                nativeMode: string | null;
+                kind: "cash" | "included" | "paid_credits" | "unknown" | "valuation";
+                source: string;
+            } | undefined;
+            knowledge: "estimated" | "exact" | "unknown";
+            billing: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
+            source: string;
+            provenance: string[];
+            estimatedUsd: number | null;
+            cashUsd: number | null;
+            valuationUsd: number | null;
+            valuationKnowledge: "estimated" | "exact" | "unknown";
+        } | null;
+        problem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors: Record<string, string[]>;
+            requiredActions: string[];
+            evidenceRefs: string[];
+            context: Record<string, unknown>;
+        } | null;
+    }>;
+};
+//# sourceMappingURL=model-operation-control.d.ts.map

package/dist/model-operation-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-operation-control.d.ts","sourceRoot":"","sources":["../src/model-operation-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;qFACqF;AACrF,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,QAAQ,CAAC,EACjG,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI;IAO7C,oBAAoB,YAAkB,UAAU,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE3E,iBAAiB,OAAa,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACpC,eAAe,OAAa,MAAM;;;;IAClC,sBAAsB,OAAa,MAAM,UAAU,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEzD,oBAAoB,YAAkB,UAAU,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG9E"}

package/dist/model-operation-control.js

@@ -0,0 +1,16 @@
+/** Existing model controls, with one synchronous snapshot of this operation's
+ * live admission facts. Provider dispatch and result custody stay in their owner. */
+export function modelOperationControlServices(operations, admission) {
+    const snapshot = (id) => {
+        const detail = operations.inspect(id);
+        return admission ? { ...detail, admission: admission(id) } : detail;
+    };
+    return {
+        createModelOperation: async (...args) => snapshot((await operations.create(...args)).id),
+        getModelOperation: async (id) => snapshot(id),
+        readModelResult: async (id) => operations.readResult(id),
+        acknowledgeModelResult: async (id, sha256) => snapshot(operations.acknowledge(id, sha256).id),
+        cancelModelOperation: async (...args) => snapshot((await operations.cancel(...args)).id),
+    };
+}
+//# sourceMappingURL=model-operation-control.js.map

package/dist/model-operation-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-operation-control.js","sourceRoot":"","sources":["../src/model-operation-control.ts"],"names":[],"mappings":"AAGA;qFACqF;AACrF,MAAM,UAAU,6BAA6B,CAC3C,UAAiG,EACjG,SAA+C;IAE/C,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IACtE,CAAC,CAAC;IACF,OAAO;QACL,oBAAoB,EAAE,KAAK,EAAE,GAAG,IAA2C,EAAE,EAAE,CAC7E,QAAQ,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,iBAAiB,EAAE,KAAK,EAAE,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,eAAe,EAAE,KAAK,EAAE,EAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAChE,sBAAsB,EAAE,KAAK,EAAE,EAAU,EAAE,MAAc,EAAE,EAAE,CAC3D,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QACjD,oBAAoB,EAAE,KAAK,EAAE,GAAG,IAA2C,EAAE,EAAE,CAC7E,QAAQ,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;AACJ,CAAC"}