@artemiskit/core 0.6.0 → 0.6.1

package/dist/agent-workflow/session.d.ts

@@ -0,0 +1,113 @@
+import type { TokenUsage } from '../adapters/types.js';
+import { type WorkflowEnvironmentFactory, type WorkflowState } from './environment.js';
+import { type AgentWorkflow } from './schema.js';
+import type { AgentTarget, AgentTurnRequest } from './target.js';
+export type AgentWorkflowExecution = 'completed' | 'unsupported' | 'invalid' | 'failed' | 'cancelled' | 'timeout' | 'budget_exceeded';
+export type AgentWorkflowReason = 'finished' | 'invalid_workflow' | 'invalid_options' | 'invalid_fixture' | 'target_unavailable' | 'invalid_response' | 'target_error' | 'tool_use_unsupported' | 'preflight_failed' | 'environment_unavailable' | 'invalid_environment' | 'tool_failed' | 'policy_denied' | 'cancelled' | 'deadline' | 'max_actions' | 'max_model_requests' | 'max_tool_calls' | 'max_tokens' | 'usage_unavailable' | 'transcript_limit';
+export interface AgentWorkflowEvent {
+    sequence: number;
+    elapsedMs: number;
+    type: 'started' | 'model_requested' | 'model_completed' | 'tool_requested' | 'tool_completed' | 'preflight_completed' | 'finished';
+    phase: 'execution' | 'preflight';
+    operationId?: string;
+    requestedCallIdHash?: string;
+    tool?: string;
+    status?: 'completed' | 'denied' | 'invalid' | 'failed';
+}
+export interface AgentWorkflowRecord {
+    schemaVersion: '1';
+    engine: 'native';
+    execution: AgentWorkflowExecution;
+    reason: AgentWorkflowReason;
+    policy: 'passed' | 'denied';
+    configuration?: {
+        sha256: string;
+        provider: {
+            sha256: string;
+            display?: string;
+        };
+        model: {
+            sha256: string;
+            display?: string;
+        };
+        generation: {
+            maxTokens: number;
+            temperature: number;
+        };
+        limits: AgentWorkflow['environment']['policy']['budgets'];
+    };
+    taskVerification: 'unavailable';
+    environment: 'simulated' | 'sandbox' | 'unknown';
+    capability: {
+        advertised: boolean | null;
+        transportCancellation: boolean;
+        preflight: 'not_requested' | 'passed' | 'failed';
+        observedModelHash?: string;
+        observedModel?: {
+            sha256: string;
+            display?: string;
+        };
+    };
+    usage: {
+        status: 'reported' | 'partial' | 'unavailable';
+        reported: TokenUsage;
+        missingRequests: number;
+        inFlightUnknown: boolean;
+        preflight: TokenUsage;
+    };
+    budgets: {
+        actions: number;
+        modelRequests: number;
+        toolCalls: number;
+        modelRequestAccounting: 'target_invocations';
+        transportAttempts: 'unavailable';
+        tokenOvershoot: number;
+        elapsedMs: number;
+    };
+    cleanup: {
+        status: 'completed' | 'unresolved';
+        artifacts: 'discarded' | 'retained' | 'unknown';
+        pendingOperations: number;
+    };
+    artifacts: {
+        state: 'available' | 'unavailable';
+        stateSha256?: string;
+        files?: {
+            pathSha256: string;
+            contentSha256: string;
+            bytes: number;
+        }[];
+        omittedFiles?: number;
+    };
+    events: AgentWorkflowEvent[];
+    droppedEvents: number;
+}
+export interface AgentWorkflowResult {
+    /** Metadata only. Safe default persistence boundary, never contains model text or fixture content. */
+    record: AgentWorkflowRecord;
+    /** Sensitive working data; persist only with an explicit application policy. */
+    state: WorkflowState | null;
+    transcript: AgentTurnRequest['messages'];
+}
+export interface AgentWorkflowSessionOptions {
+    workflow: AgentWorkflow;
+    target: AgentTarget;
+    fixtureRoot?: string;
+    environmentFactory?: WorkflowEnvironmentFactory;
+    preflight?: boolean;
+    preflightOnly?: boolean;
+    signal?: AbortSignal;
+    /** Total bounded drain/snapshot/close period: 1000 ms simulated, 6000 ms sandbox by default. */
+    cleanupTimeoutMs?: number;
+    onEvent?: (event: AgentWorkflowEvent) => void;
+}
+export interface AgentWorkflowSession {
+    readonly state: 'idle' | 'running' | 'cancelling' | 'completed';
+    run(): Promise<AgentWorkflowResult>;
+    cancel(): void;
+    events(): AsyncIterable<AgentWorkflowEvent>;
+}
+/** Native host-owned loop. No adapter or model may change authority or replenish run budgets. */
+export declare function createAgentWorkflowSession(options: AgentWorkflowSessionOptions): AgentWorkflowSession;
+export declare function runAgentWorkflow(options: AgentWorkflowSessionOptions): Promise<AgentWorkflowResult>;
+//# sourceMappingURL=session.d.ts.map

package/dist/agent-workflow/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/agent-workflow/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAEL,KAAK,0BAA0B,EAE/B,KAAK,aAAa,EAMnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,aAAa,EAAuC,MAAM,UAAU,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAmB,MAAM,UAAU,CAAC;AAG/E,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,aAAa,GACb,SAAS,GACT,QAAQ,GACR,WAAW,GACX,SAAS,GACT,iBAAiB,CAAC;AACtB,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GACV,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,oBAAoB,GACpB,kBAAkB,GAClB,cAAc,GACd,sBAAsB,GACtB,kBAAkB,GAClB,yBAAyB,GACzB,qBAAqB,GACrB,aAAa,GACb,eAAe,GACf,WAAW,GACX,UAAU,GACV,aAAa,GACb,oBAAoB,GACpB,gBAAgB,GAChB,YAAY,GACZ,mBAAmB,GACnB,kBAAkB,CAAC;AACvB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EACA,SAAS,GACT,iBAAiB,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,GACrB,UAAU,CAAC;IACf,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;CACxD;AACD,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,GAAG,CAAC;IACnB,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,sBAAsB,CAAC;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,aAAa,CAAC,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,KAAK,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5C,UAAU,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QACvD,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC;KAC3D,CAAC;IACF,gBAAgB,EAAE,aAAa,CAAC;IAChC,WAAW,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IACjD,UAAU,EAAE;QACV,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;QAC3B,qBAAqB,EAAE,OAAO,CAAC;QAC/B,SAAS,EAAE,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,aAAa,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACtD,CAAC;IACF,KAAK,EAAE;QACL,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;QAC/C,QAAQ,EAAE,UAAU,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,OAAO,CAAC;QACzB,SAAS,EAAE,UAAU,CAAC;KACvB,CAAC;IACF,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,sBAAsB,EAAE,oBAAoB,CAAC;QAC7C,iBAAiB,EAAE,aAAa,CAAC;QACjC,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,EAAE;QACP,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC;QACnC,SAAS,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;QAChD,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,SAAS,EAAE;QACT,KAAK,EAAE,WAAW,GAAG,aAAa,CAAC;QACnC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACvE,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,mBAAmB;IAClC,sGAAsG;IACtG,MAAM,EAAE,mBAAmB,CAAC;IAC5B,gFAAgF;IAChF,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;CAC1C;AACD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,0BAA0B,CAAC;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC/C;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;IAChE,GAAG,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACpC,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAAC;CAC7C;AAwJD,iGAAiG;AACjG,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,oBAAoB,CA6yBtB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}

package/dist/agent-workflow/target.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import type { ModelClient, TokenUsage, ToolCall } from '../adapters/types.js';
-declare const requestSchema: z.ZodObject<{
+export declare const agentTurnRequestSchema: z.ZodObject<{
     messages: z.ZodArray<z.ZodObject<{
         role: z.ZodEnum<["system", "user", "assistant", "tool"]>;
         content: z.ZodString;
@@ -187,16 +187,22 @@ declare const requestSchema: z.ZodObject<{
     }[];
     model?: string | undefined;
 }>;
-export type AgentTurnRequest = z.infer<typeof requestSchema>;
+export type AgentTurnRequest = z.infer<typeof agentTurnRequestSchema>;
 export type AgentTargetFailure = {
+    rejectedCall?: {
+        requestedCallIdHash: string;
+        tool: string;
+        reason: 'undeclared_tool' | 'invalid_arguments' | 'duplicate_id';
+    };
+    tokens?: TokenUsage;
+    usageAvailable?: boolean;
     status: 'unsupported' | 'invalid' | 'error';
     code: 'invalid_request' | 'tool_use_unsupported' | 'invalid_response' | 'target_error' | 'timeout' | 'aborted';
 };
 export type AgentTargetCapabilities = {
     status: 'available';
     toolUse: boolean;
-    /** ModelClient has no AbortSignal contract. Timeouts bound waiting, not transport work. */
-    transportCancellation: false;
+    transportCancellation: boolean;
 };
 export type AgentTurnResult = AgentTargetFailure | {
     status: 'completed';
@@ -209,6 +215,7 @@ export type AgentTurnResult = AgentTargetFailure | {
     };
     /** Adapter-reported counts only; zero can mean unavailable in existing adapters. */
     tokens: TokenUsage;
+    usageAvailable?: boolean;
     latencyMs: number;
     finishReason?: 'stop' | 'length' | 'tool_calls' | 'content_filter';
 };
@@ -219,12 +226,18 @@ export interface AgentTarget {
         timeoutMs: number;
     }, signal?: AbortSignal): Promise<AgentTargetCapabilities | AgentTargetFailure>;
     turn(request: AgentTurnRequest, signal?: AbortSignal): Promise<AgentTurnResult>;
+    /** Wait for underlying callbacks hidden behind a bounded turn facade. */
+    drain?(options: {
+        timeoutMs: number;
+    }): Promise<{
+        pendingOperations: number;
+    }>;
 }
+export declare function validWorkflowTranscript(messages: AgentTurnRequest['messages']): boolean;
 /**
- * Bridge existing adapters without provider-specific dispatch. Callers must configure adapter
- * transport timeouts/retries separately: cancellation here cannot stop an in-flight provider call.
+ * Bridge existing adapters without provider-specific dispatch. Workflow calls disable supported
+ * transport retries and propagate abort only when the adapter declares transport cancellation.
  * Returned text/tool arguments are working conversation data, not sanitized retained evidence.
  */
 export declare function createModelClientTarget(client: ModelClient): AgentTarget;
-export {};
 //# sourceMappingURL=target.d.ts.map

package/dist/agent-workflow/target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/agent-workflow/target.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAmB,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAqB5F,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCR,CAAC;AAkBZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;IAC5C,IAAI,EACA,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,cAAc,GACd,SAAS,GACT,SAAS,CAAC;CACf,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,qBAAqB,EAAE,KAAK,CAAC;CAC9B,CAAC;AACF,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB;IACE,MAAM,EAAE,WAAW,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IACzE,oFAAoF;IACpF,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,CAAC;CACpE,CAAC;AAEN,qGAAqG;AACrG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,YAAY,CACV,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,uBAAuB,GAAG,kBAAkB,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACjF;AA0DD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAiHxE"}
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/agent-workflow/target.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAmB,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAsB5F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCxB,CAAC;AAmBZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,CAAC,EAAE;QACb,mBAAmB,EAAE,MAAM,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,cAAc,CAAC;KAClE,CAAC;IACF,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;IAC5C,IAAI,EACA,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,cAAc,GACd,SAAS,GACT,SAAS,CAAC;CACf,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB,EAAE,OAAO,CAAC;CAChC,CAAC;AACF,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB;IACE,MAAM,EAAE,WAAW,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IACzE,oFAAoF;IACpF,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,CAAC;CACpE,CAAC;AAEN,qGAAqG;AACrG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,YAAY,CACV,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,uBAAuB,GAAG,kBAAkB,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAChF,yEAAyE;IACzE,KAAK,CAAC,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChF;AAgCD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,GAAG,OAAO,CAwBvF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAsKxE"}