@vertesia/common 1.2.0 → 1.3.0-dev.20260620.091720Z

package/lib/{types/store → store}/agent-run.d.ts

@@ -11,12 +11,13 @@
  * Client code only ever uses `AgentRun.id` — all Temporal workflow details
  * (workflowId, runId) are internal server concerns.
  */
-import { AgentSearchScope, ConversationVisibility, InteractionExecutionConfiguration, InteractionRef, RunSource } from "../interaction.js";
-import { UserChannel } from "../email.js";
-import { AgentEvent } from "../workflow-analytics.js";
-import { UserInputSignal } from "./signals.js";
-import { ContentObjectTypeRef } from "./store.js";
-import { AgentMessage, CompactMessage, ConversationActivityState, ConversationFileRef, WorkflowRunEvent } from "./workflow.js";
+import type { UserChannel } from '../email.js';
+import type { AgentSearchScope, ConversationVisibility, InteractionExecutionConfiguration, InteractionRef, RunSource } from '../interaction.js';
+import type { AgentEvent } from '../workflow-analytics.js';
+import type { ProcessDefinitionBody, ProcessState } from './process.js';
+import type { StopSignal, UserInputSignal } from './signals.js';
+import type { ContentObjectTypeRef } from './store.js';
+import type { AgentMessage, CompactMessage, ConversationActivityState, ConversationFileRef, ConversationFileRemovedRef, WorkflowRunEvent } from './workflow.js';
 /**
  * Status of an agent run through its lifecycle.
  */
@@ -35,14 +36,74 @@ export type AgentRunArchiveState = 'none' | 'pending' | 'archiving' | 'complete'
  * How the agent run was created.
  */
 export type AgentRunType = 'api' | 'schedule';
+/**
+ * Internal discriminator key for documents stored in the agent_runs collection.
+ */
+export type RunKind = 'agent' | 'process';
+/**
+ * Public-facing runtime mode.
+ */
+export type RunType = 'autonomous' | 'supervised' | 'programmatic';
+export type ProcessRunType = 'supervised' | 'programmatic';
+/**
+ * Shared fields for all records stored in the agent_runs collection.
+ */
+export interface RunBase {
+    /** The stable identifier used by all client code */
+    id: string;
+    /** Internal discriminator key */
+    run_kind: RunKind;
+    /** Public-facing runtime mode */
+    run_type: RunType;
+    /** Account ID */
+    account: string;
+    /** Project ID */
+    project: string;
+    /** Temporal workflow ID (stable across continueAsNew) */
+    workflow_id?: string;
+    /** First Temporal workflow run ID (used for Redis channel and artifact resolution) */
+    first_workflow_run_id?: string;
+    /** Artifact storage path for this run */
+    artifacts_path?: string;
+    /** Current status of the run */
+    status: AgentRunStatus;
+    /** Whether the run is currently working or idle */
+    activity_state?: ConversationActivityState;
+    /** Conversation/process visibility */
+    visibility?: ConversationVisibility;
+    /** User or service that initiated the run */
+    started_by: string;
+    /** When the run started */
+    started_at: Date;
+    /** When the run completed (or failed/cancelled) */
+    completed_at?: Date;
+    /** Short human-readable title */
+    title?: string;
+    /** User-defined or system tags for categorization */
+    tags?: string[];
+    /** Categories for organizing runs */
+    categories?: string[];
+    /** How the run was started */
+    source?: RunSource;
+    /** Replacement for legacy AgentRun.type */
+    source_type?: AgentRunType;
+    /** Schedule ID — set when this run was triggered by a Temporal schedule */
+    schedule_id?: string;
+    /** Archive lifecycle state */
+    archive_state?: AgentRunArchiveState;
+    /** Timestamp when the document was created */
+    created_at: Date;
+    /** Timestamp when the document was last updated */
+    updated_at: Date;
+}
 /**
  * Shared fields between CreateAgentRunPayload and AgentRun.
  *
  * @typeParam TData - The interaction's expected input data type.
  * @typeParam TProperties - The content type's property schema.
  */
-export interface AgentRunBase<TData = Record<string, any>, TProperties = Record<string, any>> {
-    /** Interaction ID or code (e.g. "sys:generic_question") */
+export interface AgentRunBase<TData = Record<string, unknown>, TProperties = Record<string, unknown>> {
+    /** Interaction ID or code (e.g. "sys:generic_question"). */
     interaction: string;
     /** Input parameters, typed per interaction */
     data?: TData;
@@ -69,6 +130,10 @@ export interface AgentRunBase<TData = Record<string, any>, TProperties = Record<
     /** Schedule ID — set when this run was triggered by a Temporal schedule */
     schedule_id?: string;
     /** How the run was created */
+    source_type?: AgentRunType;
+    /**
+     * @deprecated Use source_type for creation source and run_type for runtime mode.
+     */
     type?: AgentRunType;
 }
 /**
@@ -80,13 +145,9 @@ export interface AgentRunBase<TData = Record<string, any>, TProperties = Record<
  * @typeParam TData - The interaction's expected input data type.
  * @typeParam TProperties - The content type's property schema.
  */
-export interface AgentRun<TData = Record<string, any>, TProperties = Record<string, any>> extends AgentRunBase<TData, TProperties> {
-    /** The stable identifier used by all client code */
-    id: string;
-    /** Account ID */
-    account: string;
-    /** Project ID */
-    project: string;
+export interface AgentRun<TData = Record<string, unknown>, TProperties = Record<string, unknown>> extends RunBase, AgentRunBase<TData, TProperties> {
+    run_kind: 'agent';
+    run_type: 'autonomous';
     /** Temporal workflow ID (stable across continueAsNew) */
     workflow_id?: string;
     /** First Temporal workflow run ID (used for Redis channel and artifact resolution) */
@@ -120,18 +181,55 @@ export interface AgentRun<TData = Record<string, any>, TProperties = Record<stri
     last_archive_error?: string;
     /** Source agent run ID when this run was forked (enables message history chaining) */
     forked_from?: string;
-    /** Timestamp when the document was created */
-    created_at: Date;
-    /** Timestamp when the document was last updated */
-    updated_at: Date;
 }
+export interface ProcessRunConfig {
+    model?: string;
+    /**
+     * Free-form message from the user when starting a run. Passed to the
+     * orchestrator LLM in supervised mode; stored on the run regardless
+     * so programmatic runs retain the intent that triggered them.
+     */
+    user_message?: string;
+    /**
+     * Optional monitor workflow used when a process is launched as a
+     * conversation workstream. The process workflow sends checkpoint status
+     * signals to this monitor so long-running human-task processes do not need
+     * tight polling.
+     */
+    process_workstream_monitor?: {
+        monitor_workflow_id: string;
+        launch_id?: string;
+        workstream_id?: string;
+    };
+}
+export interface ProcessRun extends RunBase {
+    run_kind: 'process';
+    run_type: ProcessRunType;
+    process_id?: string;
+    process_definition_snapshot: ProcessDefinitionBody;
+    process_version?: number;
+    process_state: ProcessState;
+    config?: ProcessRunConfig;
+}
+export type AnyAgentRun = AgentRun | ProcessRun;
+export type AutonomousRunResponse<TData = Record<string, unknown>, TProperties = Record<string, unknown>> = AgentRun<TData, TProperties>;
+export type SupervisedRunResponse = ProcessRun & {
+    run_type: 'supervised';
+};
+export type ProgrammaticRunResponse = ProcessRun & {
+    run_type: 'programmatic';
+};
+/**
+ * @discriminator run_type
+ */
+export type AgentRunResponse<TData = Record<string, unknown>, TProperties = Record<string, unknown>> = AutonomousRunResponse<TData, TProperties> | SupervisedRunResponse | ProgrammaticRunResponse;
 /**
  * Payload to create and start a new agent run.
  *
  * @typeParam TData - The interaction's expected input data type.
  * @typeParam TProperties - The content type's property schema.
  */
-export interface CreateAgentRunPayload<TData = Record<string, any>, TProperties = Record<string, any>> extends AgentRunBase<TData, TProperties> {
+export interface CreateAgentRunPayload<TData = Record<string, unknown>, TProperties = Record<string, unknown>> extends AgentRunBase<TData, TProperties> {
     /** Search scope for RAG queries */
     search_scope?: AgentSearchScope;
     /** User communication channels (email, interactive) */
@@ -147,19 +245,57 @@ export interface CreateAgentRunPayload<TData = Record<string, any>, TProperties
     /** Principal ref of the user who initiated the run (for server-to-server forwarding) */
     started_by?: string;
 }
+export interface ProcessRunInputPayload<TData = Record<string, unknown>, TSource = RunSource> {
+    process_id?: string;
+    /** Optional published process version to pin. Defaults to the latest/head revision. */
+    process_version?: number;
+    process_definition?: ProcessDefinitionBody;
+    data?: TData;
+    config?: ProcessRunConfig;
+    visibility?: ConversationVisibility;
+    tags?: string[];
+    categories?: string[];
+    source?: TSource;
+    started_by?: string;
+}
+export interface CreateProcessRunPayload<TData = Record<string, unknown>, TSource = RunSource> extends ProcessRunInputPayload<TData, TSource> {
+    run_type: ProcessRunType;
+}
+export interface RecordRunWorkflowPayload {
+    /** Temporal workflow id. */
+    workflow_id: string;
+    /** First Temporal run id for this workflow. Required when the workflow has already started. */
+    first_workflow_run_id?: string;
+}
 /**
- * Payload to record an AgentRun for an already-running workflow.
- *
- * Used by server-side callers that have already started a Temporal workflow
- * and need to create the stable AgentRun MongoDB document against it.
- *
- * @typeParam TData - The interaction's expected input data type.
+ * @internal Used by workflow activities that need to create a stable run
+ * document for a workflow they already own.
  */
-export interface RecordAgentRunPayload<TData = CreateAgentRunPayload["data"]> extends Pick<AgentRunBase<TData>, "interaction" | "data" | "schedule_id" | "visibility" | "type"> {
-    /** Temporal workflow ID (stable across continueAsNew) */
-    workflow_id: string;
-    /** First Temporal workflow run ID (stable stream/artifact identity) */
+export interface RecordAgentRunPayload<TData = Record<string, unknown>> extends RecordRunWorkflowPayload {
+    run_kind?: 'agent';
+    interaction: string;
     first_workflow_run_id: string;
+    schedule_id?: string;
+    visibility?: ConversationVisibility;
+    data?: TData;
+    type?: AgentRunType;
+}
+/**
+ * @internal Used by process workflows to reserve a child ProcessRun before
+ * starting its Temporal child workflow.
+ */
+export interface RecordProcessRunPayload<TData = Record<string, unknown>, TSource = RunSource> extends ProcessRunInputPayload<TData, TSource>, RecordRunWorkflowPayload {
+    run_kind: 'process';
+    run_type?: ProcessRunType;
+}
+export type RecordRunPayload<TData = Record<string, unknown>, TSource = RunSource> = RecordAgentRunPayload<TData> | RecordProcessRunPayload<TData, TSource>;
+/**
+ * @internal Attaches the first Temporal run id after a pre-created run record
+ * has successfully started its workflow.
+ */
+export interface BindRunWorkflowPayload extends Required<RecordRunWorkflowPayload> {
+    status?: AgentRunStatus;
+    activity_state?: ConversationActivityState;
 }
 /**
  * Response from terminating an agent run.
@@ -177,6 +313,8 @@ export interface UpdateAgentRunStatusPayload {
     title?: string;
     topic?: string;
     lessons_learned?: string[];
+    /** Shallow-merged into the run's existing properties. */
+    properties?: Record<string, unknown>;
     /** ES-only: conversation content text (not stored in MongoDB) */
     content?: string;
     /** Archive state fields (set by the archive workflow) */
@@ -184,11 +322,13 @@ export interface UpdateAgentRunStatusPayload {
     archived_at?: string;
     archive_version?: number;
     last_archive_error?: string;
+    sequence?: number;
+    process_state?: ProcessState;
 }
 /**
  * Generic signal payload sent to a running agent workflow.
  */
-export type SignalAgentPayload = UserInputSignal | ConversationFileRef | Record<string, unknown>;
+export type SignalAgentPayload = UserInputSignal | StopSignal | ConversationFileRef | ConversationFileRemovedRef | Record<string, unknown>;
 /**
  * Response from signaling an agent workflow.
  */
@@ -210,6 +350,7 @@ export interface StreamAgentRunQuery extends AgentRunUpdatesQuery {
 }
 export interface AgentRunDetailsQuery {
     include_history?: boolean;
+    hydrate_payloads?: boolean;
 }
 export type AgentArtifactVisibility = 'user' | 'internal' | 'all';
 export interface AgentRunArtifactsQuery {
@@ -316,13 +457,17 @@ export interface ListAgentRunsQuery {
     schedule_id?: string;
     /** Filter by run type */
     type?: AgentRunType;
+    /** Filter by public runtime mode */
+    run_type?: RunType | RunType[];
+    /** Filter by internal run discriminator */
+    run_kind?: RunKind;
     /** Field to sort by */
     sort?: 'started_at' | 'updated_at';
     /** Sort order */
     order?: 'asc' | 'desc';
 }
 export interface ListAgentRunsResponse {
-    items: AgentRun<Record<string, unknown>, Record<string, unknown>>[];
+    items: AgentRunResponse[];
     total_count: number;
     next_cursor: string | null;
 }
@@ -344,6 +489,8 @@ export interface SearchAgentRunsQuery {
     tags?: string[];
     /** Filter by content type name */
     content_type_name?: string;
+    /** Filter by public runtime mode */
+    run_type?: RunType | RunType[];
     /** Only return runs started after this date */
     since?: Date;
     /** Only return runs started at or before this date */
@@ -352,6 +499,15 @@ export interface SearchAgentRunsQuery {
     limit?: number;
     /** Offset for pagination */
     offset?: number;
+    /**
+     * Multi-field sort. Each item has the form `field` or `field:order`, where
+     *   field is one of: `started_at`, `updated_at`
+     *   order is one of: `asc`, `desc` (default: `desc`)
+     * The first item is the primary sort; subsequent items are tie-breakers.
+     * Example: `['updated_at:desc', 'started_at:asc']`.
+     * Defaults to `['started_at:desc']` when omitted.
+     */
+    sort?: string[];
 }
 /**
  * A single search hit from Elasticsearch.
@@ -362,7 +518,11 @@ export interface AgentRunSearchHit {
     /** Relevance score */
     score: number;
     /** Interaction ID */
-    interaction: string;
+    interaction?: string;
+    /** Public-facing runtime mode */
+    run_type?: RunType;
+    /** Internal run discriminator */
+    run_kind?: RunKind;
     /** Human-readable interaction name */
     interaction_name?: string;
     /** Current status */
@@ -396,6 +556,10 @@ export interface AgentRunSearchHit {
     /** Schedule ID (if schedule-triggered) */
     schedule_id?: string;
     /** How the run was created */
+    source_type?: AgentRunType;
+    /**
+     * @deprecated Use source_type for creation source and run_type for runtime mode.
+     */
     type?: AgentRunType;
     /** Created timestamp */
     created_at: string;
@@ -421,13 +585,20 @@ export interface AgentRunInternals {
     first_workflow_run_id?: string;
     artifacts_path?: string;
     status: AgentRunStatus;
-    interaction: string;
+    run_kind?: RunKind;
+    run_type?: RunType;
+    interaction?: string;
     interaction_name?: string;
     config?: InteractionExecutionConfiguration;
-    interactive: boolean;
+    interactive?: boolean;
+    process_id?: string;
+    process_definition_snapshot?: ProcessDefinitionBody;
+    process_version?: number;
+    process_state?: ProcessState;
     started_at: Date;
     completed_at?: Date;
     started_by: string;
     created_at: Date;
     updated_at: Date;
 }
+//# sourceMappingURL=agent-run.d.ts.map

package/lib/store/agent-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run.d.ts","sourceRoot":"","sources":["../../src/store/agent-run.ts"],"names":[],"mappings":"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"}

package/lib/store/agent-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run.js","sourceRoot":"","sources":["../../src/store/agent-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/lib/{types/store → store}/collections.d.ts

@@ -1,5 +1,5 @@
-import { BaseObject } from "./common.js";
-import { ColumnLayout, ContentObjectTypeRef } from "./store.js";
+import type { BaseObject } from './common.js';
+import type { ColumnLayout, ContentObjectTypeRef } from './store.js';
 export declare enum CollectionStatus {
     active = "active",
     archived = "archived"
@@ -10,14 +10,18 @@ export interface CreateCollectionPayload {
     description?: string;
     skip_head_sync?: boolean;
     tags?: string[];
-    type?: string;
-    query?: Record<string, any>;
-    properties?: Record<string, any>;
+    type?: string | null;
+    query?: Record<string, unknown>;
+    properties?: Record<string, unknown>;
     parent?: string | null;
     table_layout?: ColumnLayout[] | null;
     allowed_types?: string[];
     updated_by?: string;
     shared_properties?: string[];
+    /** BLP sensitivity level for member documents */
+    sensitivity?: number;
+    /** Compartments for member documents */
+    compartments?: string[];
 }
 export interface CollectionItem extends BaseObject {
     /**
@@ -49,9 +53,13 @@ export interface CollectionItem extends BaseObject {
     allowed_types?: string[];
 }
 export interface Collection extends CollectionItem {
-    properties: Record<string, any>;
-    query?: Record<string, any>;
+    properties?: Record<string, unknown>;
+    query?: Record<string, unknown>;
     security?: Record<string, string[]>;
+    /** BLP sensitivity level — propagated to member documents (max across collections) */
+    sensitivity?: number;
+    /** Compartments — propagated to member documents (union across collections) */
+    compartments?: string[];
     /**
      * List of property names from the collection's properties that should be shared with (injected into) member objects.
      * These properties will be propagated to all members of this collection and merged as arrays.
@@ -93,11 +101,11 @@ export interface CollectionChildrenUpdateResult {
     count: number;
 }
 export interface CollectionMembersUpdatePayload {
-    action: "add" | "delete";
+    action: 'add' | 'delete';
     members: string[];
 }
 export interface CollectionChildrenUpdatePayload {
-    action: "add" | "delete";
+    action: 'add' | 'delete';
     children: string[];
 }
 export interface CollectionMembersQuery {
@@ -106,3 +114,4 @@ export interface CollectionMembersQuery {
     limit?: number;
     offset?: number;
 }
+//# sourceMappingURL=collections.d.ts.map

package/lib/store/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/store/collections.ts"],"names":[],"mappings":"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"}

package/lib/store/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/store/collections.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,qCAAiB,CAAA;IACjB,yCAAqB,CAAA;AACzB,CAAC,EAHW,gBAAgB,KAAhB,gBAAgB,QAG3B"}

package/lib/{types/store → store}/common.d.ts

@@ -20,3 +20,4 @@ export interface BaseObject {
     /** ISO timestamp of when the object was last updated */
     updated_at: string;
 }
+//# sourceMappingURL=common.d.ts.map

package/lib/store/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/store/common.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IAEX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IAEnB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;CACtB"}

package/lib/{cjs → store}/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/common.ts"],"names":[],"mappings":""}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/store/common.ts"],"names":[],"mappings":""}

package/lib/{types/store → store}/conversation-state.d.ts

@@ -1,7 +1,7 @@
-import { CompletionResult, ExecutionTokenUsage, StatelessExecutionOptions, ToolUse } from "@llumiverse/common";
-import { ConversationStripOptions, ResolvedInteractionExecutionInfo, UserChannel } from "../interaction.js";
-import { ExecutionRunDocRef } from "../runs.js";
-import { Plan, WorkflowAncestor } from "./workflow.js";
+import type { CompletionResult, ExecutionTokenUsage, StatelessExecutionOptions, ToolUse } from '@llumiverse/common';
+import type { ConversationStripOptions, ResolvedInteractionExecutionInfo, UserChannel } from '../interaction.js';
+import type { ExecutionRunDocRef } from '../runs.js';
+import type { Plan, WorkflowAncestor } from './workflow.js';
 /**
  * Lightweight tool reference for activity payloads.
  * References tools stored in GCP instead of embedding full tool definitions.
@@ -11,6 +11,28 @@ export interface ToolReference {
     tool_count: number;
     stored_at: string;
 }
+/** Reference to text content externalized to agent artifact storage. */
+export interface TextArtifactReference {
+    storage_id: string;
+    artifact_path: string;
+    display_ref: string;
+    sha256: string;
+    size_bytes: number;
+    content_type: string;
+}
+/**
+ * Sidecar metadata for generated tool input fields that were stored outside
+ * model-visible tool_input. Keyed by tool_use.id on ConversationState.
+ */
+export interface ExternalizedToolInputRef {
+    tool_name: string;
+    input_path: ['content'];
+    ref: TextArtifactReference;
+}
+export interface ExternalizedToolInputRefs {
+    [toolUseId: string]: ExternalizedToolInputRef[];
+}
+export declare function toolInputRefsArtifactPath(storageId: string): string;
 /**
  * Conversation state passed between workflow activities.
  * Contains all context needed to continue a multi-turn agent conversation.
@@ -32,6 +54,14 @@ export interface ConversationState {
      * The tools to call next.
      */
     tool_use?: ToolUse[];
+    /**
+     * Transport sidecar for large generated tool input fields.
+     *
+     * These refs are intentionally kept out of tool_use.tool_input so they are
+     * not shown to the model. Tool execution hydrates them from artifact storage
+     * immediately before activity validation.
+     */
+    tool_input_refs?: ExternalizedToolInputRefs;
     /**
      * The output of the this conversation step
      */
@@ -96,7 +126,7 @@ export interface ConversationState {
     /**
      * Tools that have been unlocked by skills during the conversation.
      * These tools were initially hidden (default: false) but became available
-     * when a skill with related_tools was called.
+     * when a skill with tools was called.
      */
     unlocked_tools?: string[];
     /**
@@ -104,6 +134,12 @@ export interface ConversationState {
      * Set by streamToRedis when completing async activities.
      */
     latest_activity_id?: string;
+    /**
+     * Stable streaming ID from the latest LLM call.
+     * Unlike Temporal activity IDs, this is scoped to the concrete workflow run
+     * that produced the stream, so it remains safe across continue-as-new.
+     */
+    latest_streaming_id?: string;
     /**
      * Mapping of skill names to their related tools.
      * When a skill is called, its related tools are added to unlocked_tools.
@@ -128,6 +164,15 @@ export interface ConversationState {
      * to consolidate all artifacts under the parent agent run.
      */
     launch_id?: string;
+    /**
+     * The app version this run is pinned to (candidate testing), derived from the `@version` on the
+     * started interaction ref / the `x-vertesia-app-version` header at start. Persisted on the state
+     * so it survives resume, and applied to the activity client (`withAppVersion`) so every app-owned
+     * ref the run resolves — interactions, types, processes, tools — targets this version instead of
+     * the current/promoted one. Undefined → current/promoted. Resolution-time only; never a stored
+     * capability-ref version.
+     */
+    app_version?: string;
 }
 /** Skill metadata collected at workflow start for upfront sandbox hydration */
 export interface AvailableSkill {
@@ -170,3 +215,4 @@ export interface ToolActivationMetadata {
     /** Whether this tool is pinned and should be preserved during eviction. */
     pinned?: boolean;
 }
+//# sourceMappingURL=conversation-state.d.ts.map

package/lib/store/conversation-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-state.d.ts","sourceRoot":"","sources":["../../src/store/conversation-state.ts"],"names":[],"mappings":"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"}

package/lib/{esm/store → store}/conversation-state.js

@@ -1,3 +1,6 @@
+export function toolInputRefsArtifactPath(storageId) {
+    return `agents/${storageId}/tool-input-refs.json`;
+}
 /**
  * Compute the storage ID for a conversation's artifacts.
  * - Root workflows:   `{agent_run_id}`  (or fallbackRunId if no agent_run_id)

package/lib/store/conversation-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-state.js","sourceRoot":"","sources":["../../src/store/conversation-state.ts"],"names":[],"mappings":"AAuCA,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACvD,OAAO,UAAU,SAAS,uBAAuB,CAAC;AACtD,CAAC;AAwLD;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACpC,KAAwE,EACxE,aAAqB;IAErB,MAAM,MAAM,GAAG,KAAK,EAAE,YAAY,IAAI,aAAa,CAAC;IACpD,IAAI,KAAK,EAAE,SAAS,IAAI,KAAK,EAAE,YAAY,EAAE,CAAC;QAC1C,OAAO,GAAG,MAAM,gBAAgB,KAAK,CAAC,SAAS,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}