@vertesia/common 1.5.0-dev.20260807.073259Z → 1.5.0-dev.20260901.005903Z

package/src/store/collections.ts

@@ -9,6 +9,7 @@ import type {
     CollectionSchema,
     CollectionSecuritySettingsResponseSchema,
     CreateCollectionPayloadSchema,
+    UpdateCollectionPayloadSchema,
 } from '../api-schemas/content.js';
 import type { BaseObject } from './common.js';
 import type { ColumnLayout, ContentObjectTypeRef } from './store.js';
@@ -54,12 +55,6 @@ export interface CollectionItem extends BaseObject {
 
 export type Collection = z.infer<typeof CollectionSchema>;
 
-export interface StaticCollection extends Collection {
-    dynamic: false;
-    members: string[];
-    query: never;
-}
-
 export interface DynamicCollection extends Collection {
     dynamic: true;
 }
@@ -88,3 +83,5 @@ export type CollectionMembersUpdatePayload = z.infer<typeof CollectionMembersUpd
 export type CollectionChildrenUpdatePayload = z.infer<typeof CollectionChildrenUpdatePayloadSchema>;
 
 export type CollectionMembersQuery = z.infer<typeof CollectionMembersQuerySchema>;
+
+export type UpdateCollectionPayload = z.infer<typeof UpdateCollectionPayloadSchema>;

package/src/store/conversation-state.ts

@@ -30,10 +30,6 @@ export type ExternalizedToolInputRef = z.infer<typeof ExternalizedToolInputRefSc
 
 export type ExternalizedToolInputRefs = z.infer<typeof ExternalizedToolInputRefsSchema>;
 
-export function toolInputRefsArtifactPath(storageId: string): string {
-    return `agents/${storageId}/tool-input-refs.json`;
-}
-
 /**
  * Conversation state passed between workflow activities: the activity-safe,
  * per-turn dynamic subset of a multi-turn agent conversation. Rides every
@@ -122,6 +118,15 @@ export interface ConversationState {
     /** Reference to tools stored in GCP instead of embedding full tool definitions */
     tool_reference?: ToolReference;
 
+    /**
+     * Explicit artifact-storage scope that owns `tool_reference`.
+     *
+     * Normally the catalog and conversation artifacts share a scope. Process tool nodes are the
+     * exception: their catalog is persisted once at process-run scope while each node keeps its own
+     * launch-scoped artifacts. Consumers resolving `tool_reference` must prefer this value when set.
+     */
+    tool_catalog_storage_id?: string;
+
     /** Names of currently active tools (base + unlocked). Tool definitions loaded from tool_reference. */
     active_tool_names?: string[];
 
@@ -198,8 +203,9 @@ export interface ConversationState {
      * instead of re-dumping the instructions.
      *
      * Unlike `unlocked_tools` (which must survive a checkpoint so tools stay unlocked),
-     * this list is reset when a checkpoint compacts the conversation, because the
-     * summary no longer carries the skill instructions and the next call must re-deliver them.
+     * this list tracks only instructions present in the current compacted conversation.
+     * Checkpoints restore active builtin skill bodies and preserve their names; skills
+     * that cannot be restored are removed so the next call can re-deliver them.
      */
     skill_instructions_delivered?: string[];
 
@@ -304,25 +310,6 @@ export interface AvailableSkill {
     src?: string;
 }
 
-/**
- * Compute the storage ID for a conversation's artifacts.
- * - Root workflows:   `{agent_run_id}`  (or fallbackRunId if no agent_run_id)
- * - Workstreams:      `{agent_run_id}/workstreams/{launch_id}`
- *
- * Both studio-server and workflow activities must use the same logic so
- * parent and child conversations don't overwrite each other.
- */
-export function getConversationStorageId(
-    state: Pick<ConversationState, 'agent_run_id' | 'launch_id'> | undefined,
-    fallbackRunId: string,
-): string {
-    const baseId = state?.agent_run_id || fallbackRunId;
-    if (state?.launch_id && state?.agent_run_id) {
-        return `${baseId}/workstreams/${state.launch_id}`;
-    }
-    return baseId;
-}
-
 /** Skill metadata tracked when a skill is used */
 export type UsedSkill = z.infer<typeof UsedSkillSchema>;
 

package/src/store/doc-analyzer.ts

@@ -65,30 +65,6 @@ export interface AdaptTablesParams {
      */
     process_as_csv?: boolean;
 }
-
-interface DocAnalyzerRequestBase {
-    synchronous?: boolean;
-
-    notify_endpoints?: string[];
-
-    /**
-     * What environment to use to run the request
-     * If none specified the project embedded environment will be used
-     */
-    environment?: string;
-}
-
-export interface AdaptTablesRequest extends DocAnalyzerRequestBase, AdaptTablesParams {}
-
-/**
- * Get Adapted Tables Request
- * @param raw If true, the raw data will be returned
- * @param format The format to return the data in (csv, json)
- */
-export interface GetAdaptedTablesRequestQuery {
-    raw?: boolean;
-    format: 'csv' | 'json';
-}
 /**
  * The adapted table result format
  */
@@ -96,5 +72,3 @@ export interface AdaptedTable {
     comment?: string;
     data: Record<string, unknown>[];
 }
-
-export type AdaptedTableResponse = Record<string, AdaptedTable>;

package/src/store/dsl-workflow.ts

@@ -15,7 +15,13 @@ import type {
 import type { ToolExecutionMetadata } from '../tool-execution.js';
 import type { BaseObject } from './common.js';
 import type { WorkflowExecutionPayload } from './index.js';
-import type { ParentClosePolicyType } from './temporalio.js';
+
+/**
+ * Copied from temporalio: the child-workflow parent-close policy, as authored in a DSL workflow
+ * step. Declared here rather than in `./temporalio.js` because that module is Vertesia-internal
+ * while this union is part of the public DSL that clients write.
+ */
+export type ParentClosePolicyType = 'TERMINATE' | 'ABANDON' | 'REQUEST_CANCEL' | undefined;
 
 export type DurationValue = z.infer<typeof DurationValueSchema>;
 
@@ -65,7 +71,7 @@ export interface DSLActivityExecutionPayload<ParamsT extends object> extends Wor
 export type ImportSpec = (string | Record<string, string>)[];
 export type ActivityFetchSpec = z.infer<typeof ActivityFetchSpecSchema>;
 
-export interface DSLWorkflowStepBase {
+interface DSLWorkflowStepBase {
     /**
      * The type fo the step.
      * If not set defaults to "activity"
@@ -99,6 +105,10 @@ export interface DSLChildWorkflowStep extends DSLWorkflowStepBase {
     type: 'workflow';
     // the workflow endpoint to run
     name: string;
+    /** Title displayed for the child workflow in the workflow builder. */
+    title?: string;
+    /** Description displayed for the child workflow in the workflow builder. */
+    description?: string;
     /**
      * The parameters to pass to the child workflow.
      * These parameters will be merged over the parent workflow vars and passed altogether to the child workflow.
@@ -148,7 +158,7 @@ export interface DSLChildWorkflowStep extends DSLWorkflowStepBase {
  */
 export type DSLWorkflowStep = DSLActivityStep | DSLChildWorkflowStep;
 
-export interface DSLWorkflowSpecBase {
+interface DSLWorkflowSpecBase {
     name: string;
     description?: string;
     tags?: string[];
@@ -208,7 +218,7 @@ export type DSLWorkflowSpec = DSLWorkflowSpecWithSteps | DSLWorkflowSpecWithActi
  * against the stored value for optimistic concurrency. All server-assigned on the read side, hence
  * optional here and absent from {@link DSLWorkflowSpec}.
  */
-export interface LegacyWorkflowDefinitionUpsertFields {
+interface LegacyWorkflowDefinitionUpsertFields {
     id?: string;
     created_at?: string;
     updated_at?: string;
@@ -218,9 +228,21 @@ export type WorkflowDefinitionPayloadWithSteps = DSLWorkflowSpecWithSteps & Lega
 export type WorkflowDefinitionPayloadWithActivities = DSLWorkflowSpecWithActivities &
     LegacyWorkflowDefinitionUpsertFields;
 
-/** The request body of `POST /workflows/definitions` and `PUT /workflows/definitions/:id`. */
+/** The request body of `POST /workflows/definitions`. */
 export type WorkflowDefinitionPayload = WorkflowDefinitionPayloadWithSteps | WorkflowDefinitionPayloadWithActivities;
 
+interface ExpectedEditRevision {
+    expected_edit_revision?: number;
+}
+
+export type UpdateWorkflowDefinitionPayloadWithSteps = DSLWorkflowSpecWithSteps & ExpectedEditRevision;
+export type UpdateWorkflowDefinitionPayloadWithActivities = DSLWorkflowSpecWithActivities & ExpectedEditRevision;
+
+/** The guarded request body of `PUT /workflows/definitions/:id`. */
+export type UpdateWorkflowDefinitionPayload =
+    | UpdateWorkflowDefinitionPayloadWithSteps
+    | UpdateWorkflowDefinitionPayloadWithActivities;
+
 export function withDSLWorkflowSpecDiscriminator(spec: DSLWorkflowSpecBase): DSLWorkflowSpec {
     if ('steps' in spec && spec.steps) {
         return { ...spec, spec_format: 'steps' } as DSLWorkflowSpecWithSteps;
@@ -229,6 +251,7 @@ export function withDSLWorkflowSpecDiscriminator(spec: DSLWorkflowSpecBase): DSL
 }
 
 export interface DSLWorkflowDefinition extends BaseObject, DSLWorkflowSpecBase {
+    edit_revision: number;
     // an optional JSON schema to describe the input vars of the workflow.
     input_schema?: Record<string, unknown>;
     activities?: DSLActivitySpec[];

package/src/store/grounded-extraction.ts

@@ -6,7 +6,6 @@ import type {
     GroundedExtractionVerdictSchema,
     GroundedVerificationBreakdownSchema,
 } from '../api-schemas/document-processing.js';
-import type { WorkflowRunStatus } from './workflow.js';
 
 /**
  * Document-level trust verdict for a grounded extraction. `good_to_go` means the
@@ -16,14 +15,6 @@ import type { WorkflowRunStatus } from './workflow.js';
  */
 export type GroundedExtractionVerdict = z.infer<typeof GroundedExtractionVerdictSchema>;
 
-/**
- * Canonical workflow id for object-scoped grounded extraction. Every entry point
- * must use this id so Temporal prevents overlapping extraction runs per object.
- */
-export function getGroundedExtractionWorkflowId(accountId: string, objectId: string): string {
-    return `${accountId.slice(0, 6)}:workflow_execution_request:${objectId}:grounded`;
-}
-
 /**
  * Request body to start a grounded extraction on a content object. All fields are
  * optional: with none set, the object's own content-type schema drives the
@@ -39,15 +30,6 @@ export type GroundedExtractionRequest = z.infer<typeof GroundedExtractionRequest
  */
 export type GroundedAssistantResponse = z.infer<typeof GroundedAssistantResponseSchema>;
 
-/**
- * Status of a grounded extraction workflow. Carries the doc-level verdict once the
- * run has completed and written its result.
- */
-export interface GroundedExtractionRunStatusResponse extends WorkflowRunStatus {
-    /** The trust verdict, present once the run has completed. */
-    verdict?: GroundedExtractionVerdict;
-}
-
 /**
  * How each extracted value was verified. Two kinds, both trustworthy:
  * digitally verified (matched the document's text — digital layer or OCR) and

package/src/store/index.ts

@@ -6,19 +6,13 @@ export * from './common.js';
 export * from './conversation-state.js';
 export * from './doc-analyzer.js';
 export * from './dsl-workflow.js';
-// The compiled JSON Schema for ContentTypeIntakePolicy, under the name consumers import.
 export * from './editing-policy-schema.generated.js';
 export * from './grounded-extraction.js';
-export * from './hive-memory.js';
 export * from './intake-policy-schema.generated.js';
-export * from './object-types.js';
 export * from './process.js';
-export * from './process-schema.js';
-export * from './process-validation.js';
 export * from './rendering.js';
 export * from './schedule.js';
 export * from './signals.js';
 export * from './store.js';
 export * from './task.js';
-export * from './temporalio.js';
 export * from './workflow.js';