@arnilo/prism 0.4.0 → 0.5.0

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 (171) hide show
  1. package/CHANGELOG.md +33 -1
  2. package/README.md +23 -20
  3. package/dist/agent-run-state.d.ts +1 -2
  4. package/dist/agent-run-state.js +0 -3
  5. package/dist/agent-session/session/assemble.d.ts +6 -0
  6. package/dist/agent-session/session/assemble.js +391 -0
  7. package/dist/agent-session/session/persist.d.ts +28 -0
  8. package/dist/agent-session/session/persist.js +166 -0
  9. package/dist/agent-session/session/provider-round.d.ts +6 -0
  10. package/dist/agent-session/session/provider-round.js +231 -0
  11. package/dist/agent-session/session/tool-round.d.ts +31 -0
  12. package/dist/agent-session/session/tool-round.js +473 -0
  13. package/dist/agent-session/session/types.d.ts +115 -0
  14. package/dist/agent-session/session/types.js +5 -0
  15. package/dist/agent-session/session.d.ts +49 -43
  16. package/dist/agent-session/session.js +11 -1177
  17. package/dist/capture.d.ts +63 -0
  18. package/dist/capture.js +67 -0
  19. package/dist/cli-init.d.ts +18 -2
  20. package/dist/cli-init.js +2 -7
  21. package/dist/cli-runner.d.ts +2 -2
  22. package/dist/cli-runner.js +45 -9
  23. package/dist/content.d.ts +3 -3
  24. package/dist/content.js +3 -1
  25. package/dist/contracts-core/agent.d.ts +2 -0
  26. package/dist/contracts-core/batch.d.ts +97 -0
  27. package/dist/contracts-core/batch.js +65 -0
  28. package/dist/contracts-core/content.d.ts +72 -1
  29. package/dist/contracts-core/embeddings.d.ts +30 -0
  30. package/dist/contracts-core/embeddings.js +17 -0
  31. package/dist/contracts-core/images.d.ts +60 -0
  32. package/dist/contracts-core/images.js +17 -0
  33. package/dist/contracts-core/moderation.d.ts +46 -0
  34. package/dist/contracts-core/moderation.js +34 -0
  35. package/dist/contracts-core/speech.d.ts +39 -0
  36. package/dist/contracts-core/speech.js +17 -0
  37. package/dist/contracts-core/transcription.d.ts +48 -0
  38. package/dist/contracts-core/transcription.js +17 -0
  39. package/dist/contracts-core/video.d.ts +61 -0
  40. package/dist/contracts-core/video.js +17 -0
  41. package/dist/contracts-core.d.ts +7 -0
  42. package/dist/contracts-core.js +7 -0
  43. package/dist/index.d.ts +5 -3
  44. package/dist/index.js +4 -3
  45. package/dist/node/agent-definitions.d.ts +1 -8
  46. package/dist/node/agent-definitions.js +0 -34
  47. package/dist/node/settings.d.ts +0 -1
  48. package/dist/node/settings.js +0 -5
  49. package/dist/pinned-fetch.js +29 -3
  50. package/dist/provider-events.js +3 -4
  51. package/dist/providers/media.d.ts +1 -2
  52. package/dist/providers/media.js +1 -4
  53. package/dist/rpc.d.ts +1 -1
  54. package/dist/rpc.js +4 -4
  55. package/dist/testing/provider-conformance.d.ts +114 -5
  56. package/dist/testing/provider-conformance.js +342 -0
  57. package/dist/testing/tool-effect-store-conformance.d.ts +0 -1
  58. package/dist/testing/tool-effect-store-conformance.js +0 -3
  59. package/dist/thinking.d.ts +48 -9
  60. package/dist/thinking.js +134 -8
  61. package/docs/0.1.0-readiness.md +3 -3
  62. package/docs/a2a.md +2 -2
  63. package/docs/acp.md +3 -3
  64. package/docs/ag-ui-adoption.md +1 -1
  65. package/docs/ag-ui.md +1 -2
  66. package/docs/agent-definitions.md +1 -1
  67. package/docs/agent-events.md +5 -5
  68. package/docs/agent-identity.md +13 -2
  69. package/docs/audit-export.md +3 -3
  70. package/docs/batch-jobs.md +120 -0
  71. package/docs/cli-rpc.md +20 -9
  72. package/docs/coding-agent-tools.md +19 -19
  73. package/docs/coding-review-and-diagnostics.md +2 -2
  74. package/docs/coding-security.md +4 -4
  75. package/docs/coding-workspaces.md +2 -2
  76. package/docs/computer-use-linux.md +13 -2
  77. package/docs/context-and-skills.md +1 -1
  78. package/docs/conversations.md +4 -4
  79. package/docs/credential-storage.md +11 -7
  80. package/docs/credentials-and-redaction.md +1 -1
  81. package/docs/data-classification.md +1 -1
  82. package/docs/database-persistence.md +4 -4
  83. package/docs/dev-inspector.md +6 -6
  84. package/docs/device-adapters.md +2 -2
  85. package/docs/diagrams.md +1 -1
  86. package/docs/document-reader.md +6 -6
  87. package/docs/documents.md +5 -4
  88. package/docs/embeddings.md +112 -0
  89. package/docs/enterprise-postgres-state.md +7 -7
  90. package/docs/evaluations.md +8 -8
  91. package/docs/extensions.md +3 -3
  92. package/docs/forge-integration.md +3 -3
  93. package/docs/graft.md +2 -2
  94. package/docs/guardrails.md +1 -1
  95. package/docs/host-security.md +15 -15
  96. package/docs/image-generation.md +129 -0
  97. package/docs/impeccable.md +5 -3
  98. package/docs/index.md +60 -33
  99. package/docs/indexed-code-search.md +2 -2
  100. package/docs/language-intelligence.md +4 -4
  101. package/docs/live-testing.md +126 -0
  102. package/docs/mcp-tools.md +43 -12
  103. package/docs/middleware-hooks.md +1 -1
  104. package/docs/migrate-to-0.4.md +3 -3
  105. package/docs/migrate-to-0.5.md +122 -0
  106. package/docs/migration.md +29 -1
  107. package/docs/model-registry.md +38 -0
  108. package/docs/model-routing.md +5 -5
  109. package/docs/moderation.md +117 -0
  110. package/docs/multi-agent-patterns.md +4 -4
  111. package/docs/multimodal-content.md +26 -2
  112. package/docs/obscura.md +2 -2
  113. package/docs/observability.md +32 -7
  114. package/docs/openapi-tools.md +13 -3
  115. package/docs/operations.md +11 -0
  116. package/docs/performance.md +7 -7
  117. package/docs/persistence-credentials-multimodality-primitives.md +6 -6
  118. package/docs/policy-and-audit.md +17 -7
  119. package/docs/ponytail.md +1 -1
  120. package/docs/postgres-persistence.md +5 -5
  121. package/docs/process-sessions.md +2 -2
  122. package/docs/prompt-registry.md +7 -7
  123. package/docs/provider-caching.md +4 -0
  124. package/docs/provider-conformance.md +23 -1
  125. package/docs/provider-packages.md +39 -3
  126. package/docs/provider-primitives.md +1 -1
  127. package/docs/provider-request-policies.md +1 -1
  128. package/docs/providers/ai-sdk.md +15 -3
  129. package/docs/providers/alibaba.md +5 -1
  130. package/docs/providers/anthropic.md +4 -0
  131. package/docs/providers/azure.md +17 -1
  132. package/docs/providers/bedrock.md +15 -0
  133. package/docs/providers/clinepass.md +4 -0
  134. package/docs/providers/commandcode.md +253 -0
  135. package/docs/providers/deepseek.md +4 -0
  136. package/docs/providers/google.md +4 -0
  137. package/docs/providers/hyper.md +284 -0
  138. package/docs/providers/kimi.md +4 -0
  139. package/docs/providers/neuralwatt.md +4 -0
  140. package/docs/providers/ollama.md +15 -0
  141. package/docs/providers/openai-compatible.md +4 -0
  142. package/docs/providers/openai.md +4 -0
  143. package/docs/providers/opencode-go.md +4 -0
  144. package/docs/providers/openrouter.md +5 -1
  145. package/docs/providers/vertex.md +16 -0
  146. package/docs/providers/xai.md +4 -0
  147. package/docs/providers/zai.md +4 -0
  148. package/docs/rag.md +26 -4
  149. package/docs/release-and-install.md +103 -46
  150. package/docs/resource-loading.md +1 -1
  151. package/docs/runs-and-usage.md +14 -2
  152. package/docs/server.md +5 -5
  153. package/docs/settings-auth-trust-security.md +7 -5
  154. package/docs/sheets.md +2 -2
  155. package/docs/speech.md +126 -0
  156. package/docs/sqlite-persistence.md +4 -4
  157. package/docs/supervisors.md +3 -3
  158. package/docs/thinking-and-reasoning.md +93 -60
  159. package/docs/tool-conformance.md +1 -1
  160. package/docs/tool-execution-primitives.md +8 -8
  161. package/docs/tools.md +4 -4
  162. package/docs/web-tools.md +1 -1
  163. package/docs/wiki.md +1 -1
  164. package/docs/work-artifacts-and-review.md +17 -6
  165. package/docs/work-connectors.md +4 -4
  166. package/docs/work-tools.md +5 -5
  167. package/docs/workflow-orchestration-primitives.md +11 -11
  168. package/docs/workflows.md +5 -5
  169. package/package.json +11 -8
  170. package/templates/init/providers.json +24 -8
  171. package/docs/antigravity-agent.md +0 -207
@@ -1,7 +1,11 @@
1
1
  /** session (0.2.5 plan 025 Task 1 split). Moved verbatim from agent-session.ts; public surface unchanged behind the barrel. */
2
- import type { StoredAgentRunState } from "../agent-run-state.js";
3
- import type { Agent, AgentEvent, AgentRunResult, AgentRunStateOptions, AgentSession, AgentSessionConfig, CompactionOptions, CompactionResult, OwnershipScope, RunDecision, RunOptions, SessionEntry, SteerOptions, SubscribeOptions } from "../contracts.js";
2
+ import { ActiveDurableRun } from "../agent-approval.js";
3
+ import type { PendingToolCall, StoredAgentRunState } from "../agent-run-state.js";
4
+ import type { Agent, AgentEvent, AgentRunResult, AgentRunState, AgentRunStateOptions, AgentSession, AgentSessionConfig, AIProvider, CompactionOptions, CompactionResult, ErrorInfo, Message, OwnershipScope, PendingDecision, PromptVersionRef, ProviderRequest, RunDecision, RunOptions, SessionEntry, Skill, SteerOptions, SubscribeOptions, ToolDefinition, ToolEffectStore, Usage } from "../contracts.js";
5
+ import type { AgentIdentity } from "../identity.js";
4
6
  import type { AgentInput } from "../input.js";
7
+ import type { RunLimitTracker } from "../run-limits.js";
8
+ import type { SessionContextSnapshot } from "../session-stores.js";
5
9
  import type { LoadedSkillBodiesEntry } from "../skill-load.js";
6
10
  export declare class RuntimeAgentSession implements AgentSession {
7
11
  readonly id: string;
@@ -14,33 +18,36 @@ export declare class RuntimeAgentSession implements AgentSession {
14
18
  private activeRun?;
15
19
  private activeRunId?;
16
20
  private activeProviderTurnAbort?;
17
- private pendingSoftInterrupt;
21
+ pendingSoftInterrupt: boolean;
18
22
  private pendingSteers;
19
23
  private pendingSteerBytes;
20
24
  private activeRedactor?;
21
- private activeProvider?;
25
+ activeProvider?: AIProvider;
22
26
  private activeLedger?;
23
- private activeEffectStore?;
27
+ activeEffectStore?: ToolEffectStore;
24
28
  private activeOwnership?;
25
- private activeIdentity?;
29
+ activeIdentity?: AgentIdentity;
26
30
  private activeIdempotencyKey?;
27
31
  private activeGuardrails?;
28
- private activeMetadata?;
29
- private activePromptVersion?;
30
- private activeLimits?;
31
- private activeLimitOutputBuffer;
32
- private activeDurable?;
33
- private activeLoop?;
32
+ activeMetadata?: Readonly<Record<string, unknown>>;
33
+ activePromptVersion?: PromptVersionRef;
34
+ activeLimits?: RunLimitTracker;
35
+ activeLimitOutputBuffer: boolean;
36
+ activeDurable?: ActiveDurableRun;
37
+ activeLoop?: import("../contracts.js").AgentLoopStrategy;
34
38
  /** Gated calls of the current tool round awaiting one collected suspension. */
35
- private activeGatedRound?;
36
- private activeLoopTurn;
39
+ activeGatedRound?: Map<string, {
40
+ entry: PendingToolCall;
41
+ decision: PendingDecision;
42
+ }>;
43
+ activeLoopTurn: number;
37
44
  private readonly loadedSkills;
38
45
  /** Tools activated via `search_tools` this session (plan 041); names-only in persistence. */
39
- private readonly activatedTools;
46
+ readonly activatedTools: import("../tool-search.js").ActiveToolSet;
40
47
  /** Plan 018 Task 6 (closeout `checkpoint-bodies`): persisted exact instructions, registry-independent. */
41
- private restoredSkillBodies;
48
+ restoredSkillBodies: readonly LoadedSkillBodiesEntry[];
42
49
  /** Skills of the current run (for the bodies snapshot); replaced at each run start. */
43
- private activeRunSkills;
50
+ activeRunSkills: readonly import("../contracts.js").Skill[];
44
51
  /** Plan 015 Task 4: re-add persisted loaded-skill names (names only; bodies re-resolve on demand). */
45
52
  restoreLoadedSkills(names: readonly string[]): void;
46
53
  /** Plan 041: re-add persisted activated-tool names (names only; inert for absent tools). */
@@ -66,15 +73,16 @@ export declare class RuntimeAgentSession implements AgentSession {
66
73
  private runInternal;
67
74
  prompt(input: string, options?: RunOptions): Promise<AgentRunResult>;
68
75
  stream(input: AgentInput, options?: RunOptions & SubscribeOptions): AsyncGenerator<AgentEvent>;
69
- private buildRunResult;
70
- private suspendDurable;
71
- /** First attributed sticky whose scope and delegation path exactly match a nested decision. */
72
- private matchNestedSticky;
73
- /** First sticky decision whose scope exactly matches this call, if any. */
74
- private matchStickyDecision;
75
- /** Redacted pending-decision descriptor for one gated call; never carries raw arguments. */
76
- private buildPendingDecision;
77
- private persistDurable;
76
+ buildRunResult(input: {
77
+ readonly runId: string;
78
+ readonly status: AgentRunResult["status"];
79
+ readonly usage?: Usage;
80
+ readonly limit?: import("../contracts.js").RunLimitBreach;
81
+ readonly error?: ErrorInfo;
82
+ readonly abortReason?: string;
83
+ readonly runState?: AgentRunState;
84
+ readonly interruption?: import("../contracts.js").AgentRunInterruption;
85
+ }): AgentRunResult;
78
86
  compact(options?: CompactionOptions): Promise<CompactionResult>;
79
87
  abort(reason?: unknown): void;
80
88
  entries(): Promise<readonly SessionEntry[]>;
@@ -87,22 +95,20 @@ export declare class RuntimeAgentSession implements AgentSession {
87
95
  readonly leafId?: string;
88
96
  }): Promise<AgentSession>;
89
97
  private branchReader;
90
- private resolveRunProvider;
91
- private resolveRunSkills;
92
- private emit;
93
- private closeSubscribers;
94
- private drainLedger;
95
- private generateWithRetry;
96
- private generateProviderTurn;
97
- private applyPendingSteers;
98
- private applyProviderRequestPolicies;
99
- private appendMessage;
100
- private autoCompact;
98
+ resolveRunProvider(options: RunOptions): void;
99
+ resolveRunSkills(options: RunOptions, tools: readonly ToolDefinition[]): readonly Skill[];
100
+ emit(event: AgentEvent): void;
101
+ closeSubscribers(): void;
102
+ drainLedger(): Promise<void>;
103
+ applyPendingSteers(runId: string, metadata: Readonly<Record<string, unknown>>, signal: AbortSignal): Promise<boolean>;
104
+ applyProviderRequestPolicies(request: ProviderRequest, runId: string, options: RunOptions, metadata: Readonly<Record<string, unknown>>, signal: AbortSignal): Promise<import("../contracts.js").ProviderRequestPolicyResult>;
105
+ appendMessage(message: Message, runId: string): Promise<void>;
106
+ autoCompact(runId: string, options: RunOptions, signal: AbortSignal, inputMessages: readonly Message[]): Promise<void>;
101
107
  private compactBranch;
102
- private appendEntry;
103
- private invalidateSnapshot;
104
- private redact;
105
- private redactProviderRequest;
106
- private rebuildHistory;
107
- private snapshot;
108
+ appendEntry(entry: SessionEntry): Promise<void>;
109
+ invalidateSnapshot(): void;
110
+ redact<T>(value: T): T;
111
+ redactProviderRequest(request: ProviderRequest): ProviderRequest;
112
+ rebuildHistory(): Promise<void>;
113
+ snapshot(): Promise<SessionContextSnapshot>;
108
114
  }