@artemiskit/core 0.5.3 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/README.md +12 -0
  3. package/dist/adapters/factory.d.ts +1 -1
  4. package/dist/adapters/index.d.ts +3 -3
  5. package/dist/adapters/registry.d.ts +1 -1
  6. package/dist/adapters/types.d.ts +7 -0
  7. package/dist/adapters/types.d.ts.map +1 -1
  8. package/dist/agent-evaluation/index.d.ts +2 -2
  9. package/dist/agent-evaluation/scorer.d.ts +1 -1
  10. package/dist/agent-workflow/catalog.d.ts +28 -0
  11. package/dist/agent-workflow/catalog.d.ts.map +1 -0
  12. package/dist/agent-workflow/environment.d.ts +47 -0
  13. package/dist/agent-workflow/environment.d.ts.map +1 -0
  14. package/dist/agent-workflow/index.d.ts +10 -0
  15. package/dist/agent-workflow/index.d.ts.map +1 -0
  16. package/dist/agent-workflow/parser.d.ts +7 -0
  17. package/dist/agent-workflow/parser.d.ts.map +1 -0
  18. package/dist/agent-workflow/sandbox-fixtures/qualify.d.ts +2 -0
  19. package/dist/agent-workflow/sandbox-fixtures/qualify.d.ts.map +1 -0
  20. package/dist/agent-workflow/sandbox.d.ts +12 -0
  21. package/dist/agent-workflow/sandbox.d.ts.map +1 -0
  22. package/dist/agent-workflow/schema.d.ts +774 -0
  23. package/dist/agent-workflow/schema.d.ts.map +1 -0
  24. package/dist/agent-workflow/session.d.ts +113 -0
  25. package/dist/agent-workflow/session.d.ts.map +1 -0
  26. package/dist/agent-workflow/simulated-tools.d.ts +35 -0
  27. package/dist/agent-workflow/simulated-tools.d.ts.map +1 -0
  28. package/dist/agent-workflow/target.d.ts +243 -0
  29. package/dist/agent-workflow/target.d.ts.map +1 -0
  30. package/dist/artifacts/index.d.ts +2 -2
  31. package/dist/artifacts/manifest.d.ts +1 -1
  32. package/dist/artifacts/types.d.ts +2 -2
  33. package/dist/comparison/eligibility.d.ts +1 -1
  34. package/dist/comparison/index.d.ts +1 -1
  35. package/dist/evaluators/combined.d.ts +2 -2
  36. package/dist/evaluators/contains.d.ts +2 -2
  37. package/dist/evaluators/exact.d.ts +2 -2
  38. package/dist/evaluators/fuzzy.d.ts +2 -2
  39. package/dist/evaluators/index.d.ts +13 -13
  40. package/dist/evaluators/inline.d.ts +2 -2
  41. package/dist/evaluators/json-schema.d.ts +2 -2
  42. package/dist/evaluators/llm-grader.d.ts +2 -2
  43. package/dist/evaluators/not-contains.d.ts +2 -2
  44. package/dist/evaluators/regex.d.ts +2 -2
  45. package/dist/evaluators/similarity.d.ts +2 -2
  46. package/dist/evaluators/tool-trace.d.ts +2 -2
  47. package/dist/evaluators/types.d.ts +3 -3
  48. package/dist/index.d.ts +15 -14
  49. package/dist/index.d.ts.map +1 -1
  50. package/dist/index.js +17827 -15174
  51. package/dist/provenance/execution-provenance.d.ts +1 -1
  52. package/dist/provenance/git.d.ts +1 -1
  53. package/dist/provenance/index.d.ts +4 -4
  54. package/dist/provenance/workload-identity.d.ts +2 -2
  55. package/dist/redaction/index.d.ts +2 -2
  56. package/dist/redaction/redactor.d.ts +1 -1
  57. package/dist/runner/executor.d.ts +3 -3
  58. package/dist/runner/index.d.ts +3 -3
  59. package/dist/runner/runner.d.ts +1 -1
  60. package/dist/runner/types.d.ts +5 -5
  61. package/dist/scenario/index.d.ts +4 -4
  62. package/dist/scenario/parser.d.ts +1 -1
  63. package/dist/scenario/variables.d.ts +1 -1
  64. package/dist/storage/factory.d.ts +1 -1
  65. package/dist/storage/index.d.ts +4 -4
  66. package/dist/storage/local.d.ts +2 -2
  67. package/dist/storage/supabase.d.ts +2 -2
  68. package/dist/storage/types.d.ts +2 -2
  69. package/dist/tools/fixture-executor.d.ts +2 -2
  70. package/dist/tools/index.d.ts +3 -3
  71. package/dist/tools/types.d.ts +1 -1
  72. package/dist/utils/index.d.ts +2 -2
  73. package/dist/validator/index.d.ts +2 -2
  74. package/dist/validator/validator.d.ts +1 -1
  75. package/package.json +4 -4
  76. package/src/adapters/types.ts +7 -0
  77. package/src/agent-workflow/catalog.ts +220 -0
  78. package/src/agent-workflow/environment.ts +207 -0
  79. package/src/agent-workflow/index.ts +10 -0
  80. package/src/agent-workflow/parser.ts +43 -0
  81. package/src/agent-workflow/sandbox-fixtures/qualify.ts +305 -0
  82. package/src/agent-workflow/sandbox.test.ts +117 -0
  83. package/src/agent-workflow/sandbox.ts +438 -0
  84. package/src/agent-workflow/schema.test.ts +218 -0
  85. package/src/agent-workflow/schema.ts +270 -0
  86. package/src/agent-workflow/session.test.ts +629 -0
  87. package/src/agent-workflow/session.ts +1119 -0
  88. package/src/agent-workflow/simulated-tools.test.ts +177 -0
  89. package/src/agent-workflow/simulated-tools.ts +230 -0
  90. package/src/agent-workflow/target.test.ts +280 -0
  91. package/src/agent-workflow/target.ts +357 -0
  92. package/src/index.ts +3 -0
package/CHANGELOG.md CHANGED
@@ -1,5 +1,33 @@
1
1
  # @artemiskit/core
2
2
 
3
+ ## 0.6.1
4
+
5
+ ### Patch Changes
6
+
7
+ - Add native controlled workflow execution for milestone 0.6.1. CLI workflow run/preflight and SDK
8
+ sessions share strict tool and permission enforcement, cumulative budgets, explicit tool-protocol
9
+ preflight, measured-usage states, bounded events, cancellation, and truthful cleanup evidence.
10
+ Run against detached simulated state or a disposable Docker filesystem with a fixed local image,
11
+ no host mounts or network, and no arbitrary command tool. Save bounded execution metadata separately
12
+ from explicitly requested sensitive state exports. Task verification remains unavailable until 0.6.2.
13
+
14
+ OpenAI and Ling workflow transports forward abort signals, disable automatic retries, and distinguish
15
+ missing or malformed token usage from explicitly measured zero. Preserve existing scenario APIs and
16
+ offline workflow validation. Package versions remain independent of the milestone label.
17
+
18
+ ## 0.6.0
19
+
20
+ ### Minor Changes
21
+
22
+ - 2ca73a5: Introduce the 0.6.0 agent-workflow contract: strict versioned scenarios, twelve simulated tools,
23
+ provider-neutral single-turn targets, CLI authoring and offline validation, and public SDK exports.
24
+ Preserve OpenAI structured tool-call transcripts for continuation. Full workflow execution,
25
+ cumulative budgets, sandbox environments, scoring and recovery remain later milestones.
26
+
27
+ Publish Node-compatible library bundles and NodeNext-compatible TypeScript declarations, verified
28
+ with fresh tarball consumers on Node 24 and Bun 1.3. The CLI and Docker MCP server retain Bun entry
29
+ points. Package versions remain independent; the milestone release manifest records their mapping.
30
+
3
31
  ## 0.5.3
4
32
 
5
33
  ### Patch Changes
package/README.md CHANGED
@@ -22,6 +22,18 @@ This package provides the foundational components for ArtemisKit:
22
22
 
23
23
  ## Usage
24
24
 
25
+ Controlled agent workflows use `createAgentWorkflowSession({ workflow, target })` or
26
+ `runAgentWorkflow({ workflow, target })`, with `createModelClientTarget(client)` for existing adapters.
27
+ The native session enforces declared tools, original argument schemas, permissions, cumulative
28
+ budgets, and bounded cancellation/cleanup. Environments are fresh simulated state or a disposable
29
+ Docker filesystem; unsupported authority fails closed.
30
+
31
+ The returned `record` contains bounded metadata. `state` and `transcript` are sensitive working data
32
+ and are not persisted automatically. `taskVerification` remains `unavailable` in 0.6.1; outcome
33
+ assertions are retained for 0.6.2. See the
34
+ [execution guide](https://github.com/code-sensei/artemiskit/blob/main/docs/workflow-execution.md)
35
+ for session events, transport limits, Docker prerequisites, and CLI/SDK use.
36
+
25
37
  Most users should use the [`@artemiskit/cli`](https://www.npmjs.com/package/@artemiskit/cli) package for running evaluations. This package is primarily for programmatic usage or building custom integrations.
26
38
 
27
39
  ```typescript
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Adapter factory for creating model clients
3
3
  */
4
- import type { AdapterConfig, ModelClient, ProviderType } from './types';
4
+ import type { AdapterConfig, ModelClient, ProviderType } from './types.js';
5
5
  /**
6
6
  * Create a model adapter from configuration
7
7
  */
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Adapter module exports
3
3
  */
4
- export * from './types';
5
- export * from './factory';
6
- export * from './registry';
4
+ export * from './types.js';
5
+ export * from './factory.js';
6
+ export * from './registry.js';
7
7
  //# sourceMappingURL=index.d.ts.map
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Adapter registry for dynamic adapter management
3
3
  */
4
- import type { AdapterConfig, ModelClient, ProviderType } from './types';
4
+ import type { AdapterConfig, ModelClient, ProviderType } from './types.js';
5
5
  type AdapterFactory = (config: AdapterConfig) => Promise<ModelClient>;
6
6
  interface UnavailableInfo {
7
7
  provider: ProviderType;
@@ -28,6 +28,10 @@ export interface ToolCall {
28
28
  * Options for generating a completion
29
29
  */
30
30
  export interface GenerateOptions {
31
+ /** Optional transport cancellation; consult capabilities before relying on it. */
32
+ signal?: AbortSignal;
33
+ /** Override retries per request when a host owns cumulative admission budgets. */
34
+ maxRetries?: number;
31
35
  prompt: string | ChatMessage[];
32
36
  model?: string;
33
37
  maxTokens?: number;
@@ -76,6 +80,8 @@ export interface TokenUsage {
76
80
  * Result from a generation request
77
81
  */
78
82
  export interface GenerateResult {
83
+ /** False when zero counts are placeholders rather than provider-reported usage. */
84
+ usageAvailable?: boolean;
79
85
  id: string;
80
86
  model: string;
81
87
  text: string;
@@ -93,6 +99,7 @@ export interface GenerateResult {
93
99
  * Model capabilities
94
100
  */
95
101
  export interface ModelCapabilities {
102
+ transportCancellation?: boolean;
96
103
  streaming: boolean;
97
104
  functionCalling: boolean;
98
105
  toolUse: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,kBAAkB,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,SAAS,GAAG,UAAU,CAAA;KAAE,CAAC;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,eAAe,GAAG,YAAY,GAAG,gBAAgB,CAAC;IACrF,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE5D,MAAM,CAAC,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAE3F,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAExD,YAAY,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE3C,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,cAAc,GACd,WAAW,GACX,WAAW,GACX,WAAW,GACX,YAAY,GACZ,MAAM,GACN,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,aAAa,GACb,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,QAAQ,EAAE,WAAW,CAAC;IACtB,kBAAkB,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,QAAQ,EAAE,WAAW,CAAC;IACtB,iCAAiC;IACjC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,CAAC;IACtD,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,QAAQ,EAAE,YAAY,CAAC;IACvB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mCAAmC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,wBAAwB,GACxB,qBAAqB,GACrB,sBAAsB,GACtB,iBAAiB,GACjB,sBAAsB,GACtB,uBAAuB,GACvB,iBAAiB,CAAC"}
@@ -1,3 +1,3 @@
1
- export * from './types';
2
- export * from './scorer';
1
+ export * from './types.js';
2
+ export * from './scorer.js';
3
3
  //# sourceMappingURL=index.d.ts.map
@@ -1,4 +1,4 @@
1
- import { type AgentOutcome, type AgentTask } from './types';
1
+ import { type AgentOutcome, type AgentTask } from './types.js';
2
2
  export type AgentTerminationStatus = 'completed' | 'agent_error' | 'tool_error' | 'infrastructure_error' | 'timed_out';
3
3
  export interface AgentTerminationEvidence {
4
4
  status: AgentTerminationStatus;
@@ -0,0 +1,28 @@
1
+ /** Versioned run-local capabilities shared by simulated and disposable sandbox environments. */
2
+ export declare const WORKFLOW_TOOL_IDS: readonly ["search", "read_document", "query_records", "read_file", "write_file", "calculator", "get_workflow_state", "request_approval", "record_decision", "draft_message", "delegate_task", "get_task_status"];
3
+ export type WorkflowToolId = (typeof WORKFLOW_TOOL_IDS)[number];
4
+ export type WorkflowResource = 'documents' | 'records' | 'files' | 'computation' | 'workflow_state' | 'communication' | 'coordination';
5
+ export interface WorkflowToolDescriptor {
6
+ id: WorkflowToolId;
7
+ version: '1';
8
+ family: string;
9
+ description: string;
10
+ inputSchema: Record<string, unknown>;
11
+ outputSchema: Record<string, unknown>;
12
+ authority: {
13
+ resource: WorkflowResource;
14
+ access: 'read' | 'write' | 'none';
15
+ network: 'denied';
16
+ /** V1's simulated label means run-local effects; file storage follows the selected environment. */
17
+ sideEffects: 'none' | 'simulated';
18
+ };
19
+ evidence: {
20
+ mode: 'metadata_only';
21
+ maxBytes: 1024;
22
+ };
23
+ failureModes: string[];
24
+ }
25
+ /** Defensive copies prevent callers or adapters from modifying the catalog's authority. */
26
+ export declare function listWorkflowTools(): WorkflowToolDescriptor[];
27
+ export declare function getWorkflowTool(id: string): WorkflowToolDescriptor | undefined;
28
+ //# sourceMappingURL=catalog.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/agent-workflow/catalog.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,kNAapB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,SAAS,GACT,OAAO,GACP,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,cAAc,CAAC;AAEnB,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,cAAc,CAAC;IACnB,OAAO,EAAE,GAAG,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,EAAE;QACT,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;QAClC,OAAO,EAAE,QAAQ,CAAC;QAClB,mGAAmG;QACnG,WAAW,EAAE,MAAM,GAAG,WAAW,CAAC;KACnC,CAAC;IACF,QAAQ,EAAE;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC;IACpD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAyKD,2FAA2F;AAC3F,wBAAgB,iBAAiB,IAAI,sBAAsB,EAAE,CAE5D;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAG9E"}
@@ -0,0 +1,47 @@
1
+ import { type AgentWorkflow, type WorkflowJson } from './schema.js';
2
+ import { type SimulatedToolResult } from './simulated-tools.js';
3
+ export type WorkflowState = {
4
+ [key: string]: WorkflowJson;
5
+ };
6
+ export interface WorkflowEnvironmentCleanup {
7
+ status: 'completed' | 'unresolved';
8
+ artifacts: 'discarded' | 'retained' | 'unknown';
9
+ }
10
+ /** Factories report unresolved partially-created resources without disclosing engine errors. */
11
+ export declare class WorkflowEnvironmentInitializationError extends Error {
12
+ readonly cleanup: WorkflowEnvironmentCleanup & {
13
+ pendingOperations: number;
14
+ };
15
+ constructor(cleanup: WorkflowEnvironmentCleanup & {
16
+ pendingOperations: number;
17
+ });
18
+ }
19
+ /** Trusted host extension, never constructed from model output. Implementations must honor abort. */
20
+ export interface WorkflowEnvironment {
21
+ readonly type: 'simulated' | 'sandbox';
22
+ readonly capabilities: {
23
+ network: 'denied';
24
+ commands: 'denied';
25
+ externalSideEffects: 'denied';
26
+ isolation: 'memory' | 'container';
27
+ };
28
+ execute(request: {
29
+ tool: string;
30
+ input: WorkflowJson;
31
+ }, signal: AbortSignal): Promise<SimulatedToolResult>;
32
+ snapshot(signal: AbortSignal): Promise<WorkflowState>;
33
+ close(signal: AbortSignal): Promise<WorkflowEnvironmentCleanup>;
34
+ }
35
+ export type WorkflowEnvironmentFactory = (options: {
36
+ workflow: AgentWorkflow;
37
+ initialState: WorkflowState;
38
+ signal: AbortSignal;
39
+ }) => Promise<WorkflowEnvironment>;
40
+ export declare function isWorkflowState(value: unknown): value is WorkflowState;
41
+ /** Exact relative path grants, no globs or path normalization that could hide traversal. */
42
+ export declare function workflowPathAllowed(workflow: AgentWorkflow, tool: string, input: WorkflowJson): boolean;
43
+ export declare function workflowToolPermitted(workflow: AgentWorkflow, tool: string): boolean;
44
+ /** Fixture files are explicit, bounded JSON/YAML data. Hidden/credential paths never load. */
45
+ export declare function resolveWorkflowInitialState(workflow: AgentWorkflow, fixtureRoot?: string): Promise<WorkflowState>;
46
+ export declare const createSimulatedWorkflowEnvironment: WorkflowEnvironmentFactory;
47
+ //# sourceMappingURL=environment.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/agent-workflow/environment.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,YAAY,EAGlB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,mBAAmB,EAAwB,MAAM,mBAAmB,CAAC;AAEnF,MAAM,MAAM,aAAa,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAC5D,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC;IACnC,SAAS,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;CACjD;AACD,gGAAgG;AAChG,qBAAa,sCAAuC,SAAQ,KAAK;IACnD,QAAQ,CAAC,OAAO,EAAE,0BAA0B,GAAG;QAAE,iBAAiB,EAAE,MAAM,CAAA;KAAE;gBAAnE,OAAO,EAAE,0BAA0B,GAAG;QAAE,iBAAiB,EAAE,MAAM,CAAA;KAAE;CAGzF;AACD,qGAAqG;AACrG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE;QACrB,OAAO,EAAE,QAAQ,CAAC;QAClB,QAAQ,EAAE,QAAQ,CAAC;QACnB,mBAAmB,EAAE,QAAQ,CAAC;QAC9B,SAAS,EAAE,QAAQ,GAAG,WAAW,CAAC;KACnC,CAAC;IACF,OAAO,CACL,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,EAC9C,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtD,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACjE;AACD,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,EAAE;IACjD,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;CACrB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEnC,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAItE;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,GAClB,OAAO,CAUT;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CASpF;AAED,8FAA8F;AAC9F,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,aAAa,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,CAAC,CAsExB;AAED,eAAO,MAAM,kCAAkC,EAAE,0BAkDhD,CAAC"}
@@ -0,0 +1,10 @@
1
+ /** Versioned workflow contracts, primitives, and native controlled execution. */
2
+ export * from './schema.js';
3
+ export * from './parser.js';
4
+ export * from './catalog.js';
5
+ export * from './simulated-tools.js';
6
+ export * from './target.js';
7
+ export * from './environment.js';
8
+ export * from './sandbox.js';
9
+ export * from './session.js';
10
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-workflow/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AAEzB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}
@@ -0,0 +1,7 @@
1
+ import { type AgentWorkflow } from './schema.js';
2
+ export declare function validateAgentWorkflow(value: unknown): AgentWorkflow;
3
+ /** Parse without environment substitution or fixture dereferencing. */
4
+ export declare function parseAgentWorkflow(yamlText: string): AgentWorkflow;
5
+ /** Reads only the explicitly supplied scenario; the session resolves fixtures when execution begins. */
6
+ export declare function loadAgentWorkflow(filePath: string): Promise<AgentWorkflow>;
7
+ //# sourceMappingURL=parser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/agent-workflow/parser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,UAAU,CAAC;AAEnE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAWnE;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAYlE;AAED,wGAAwG;AACxG,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAQhF"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=qualify.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"qualify.d.ts","sourceRoot":"","sources":["../../../src/agent-workflow/sandbox-fixtures/qualify.ts"],"names":[],"mappings":""}
@@ -0,0 +1,12 @@
1
+ import { type WorkflowEnvironmentFactory } from './environment.js';
2
+ export declare const WORKFLOW_SANDBOX_IMAGE = "oven/bun:1.3.10-alpine";
3
+ export interface DockerWorkflowEnvironmentOptions {
4
+ /** Per Docker operation. Run/session deadlines can abort sooner. Defaults to 5000. */
5
+ operationTimeoutMs?: number;
6
+ /** Exact owned-container cleanup deadline. Defaults to 3000; failures remain unresolved. */
7
+ cleanupTimeoutMs?: number;
8
+ }
9
+ /** Fixed local Docker image and host-owned tools. No command, environment, mount, or image override. */
10
+ export declare function createDockerWorkflowEnvironmentFactory(options?: DockerWorkflowEnvironmentOptions): WorkflowEnvironmentFactory;
11
+ export declare const createDockerWorkflowEnvironment: WorkflowEnvironmentFactory;
12
+ //# sourceMappingURL=sandbox.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/agent-workflow/sandbox.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,0BAA0B,EAIhC,MAAM,eAAe,CAAC;AAIvB,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,MAAM,WAAW,gCAAgC;IAC/C,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAwED,wGAAwG;AACxG,wBAAgB,sCAAsC,CACpD,OAAO,GAAE,gCAAqC,GAC7C,0BAA0B,CAsV5B;AACD,eAAO,MAAM,+BAA+B,EAAE,0BACJ,CAAC"}