@vertesia/common 0.24.0-dev.202601221707

package/lib/types/rate-limiter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Rate Limiter Types
+ */
+export interface RateLimiterCapacity {
+    current: number;
+    base: number;
+    max: number;
+}
+export interface RateLimiterBreakerState {
+    state: 'open' | 'closed';
+    is_open: boolean;
+    last_opened_at?: string;
+    consecutive_failures?: number;
+}
+export interface RateLimiterModelStatus {
+    model_id: string;
+    admitted: number;
+    delayed: number;
+    capacity: RateLimiterCapacity;
+    breaker: RateLimiterBreakerState;
+    last_updated: string;
+}
+export interface RateLimiterStatus {
+    environment_id: string;
+    model_id: string;
+    status: RateLimiterModelStatus;
+}
+export type RateLimiterStatusResponse = RateLimiterStatus[];

package/lib/types/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,uBAAuB,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,sBAAsB,CAAC;CAClC;AAGD,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,EAAE,CAAC"}

package/lib/types/refs.d.ts

@@ -0,0 +1,22 @@
+export declare enum ResolvableRefType {
+    project = "Project",
+    projects = "Projects",
+    environment = "Environment",
+    user = "User",
+    account = "Account",
+    interaction = "Interaction",
+    userGroup = "UserGroup"
+}
+export interface ResolvableRef {
+    type: ResolvableRefType;
+    id: string;
+}
+export interface RefResolutionRequest {
+    refs: ResolvableRef[];
+}
+export interface ResourceRef {
+    id: string;
+    name: string;
+    type: string;
+    description?: string;
+}

package/lib/types/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/refs.ts"],"names":[],"mappings":"AAEA,oBAAY,iBAAiB;IACzB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;CAC1B;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,iBAAiB,CAAA;IACvB,EAAE,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,oBAAoB;IAEjC,IAAI,EAAE,aAAa,EAAE,CAAA;CAExB;AAGD,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB"}

package/lib/types/runs.d.ts

@@ -0,0 +1,32 @@
+import { FacetResult } from './facets.js';
+import { NamedInteractionExecutionPayload } from './interaction.js';
+/**
+ * The run ref is used to identify a run document in the storage
+ */
+export interface ExecutionRunDocRef {
+    id: string;
+    account: string;
+    project: string;
+}
+/**
+ * Interaction execution payload for creating a new run
+ * It uses interaction field (from NamedInteractionExecutionPayload) to pass the interaction ID to run
+ */
+export interface RunCreatePayload extends NamedInteractionExecutionPayload {
+}
+/**
+ * To be used as a value for a numeric or date filters
+ */
+export interface RangeValue {
+    gt?: number | string;
+    gte?: number | string;
+    lt?: number | string;
+    lte?: number | string;
+}
+export interface RunSearchMetaResponse {
+    count: {
+        lower_bound?: number;
+        total?: number;
+    };
+    facet: Record<string, FacetResult>;
+}

package/lib/types/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,gCAAgC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAE;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CACrC"}

package/lib/types/skill.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Skill types for interaction-based skills.
+ *
+ * Skills are interactions with `agent_runner_options.is_skill = true`.
+ * They provide contextual instructions to agents without executing code.
+ * When a skill is called, its rendered prompt is returned as instructions.
+ *
+ * Skills can have associated scripts stored at:
+ *   skills/{skill_name}/*.py, *.js, etc.
+ * These are automatically synced to the sandbox when the skill is used.
+ */
+/**
+ * Context provided when searching for relevant skills
+ */
+export interface SkillContext {
+    /**
+     * The task description or user prompt
+     */
+    task_description?: string;
+    /**
+     * Tools currently being used or available
+     */
+    tool_names?: string[];
+    /**
+     * Sample of input data for pattern matching
+     */
+    data_sample?: string;
+    /**
+     * Additional keywords to consider
+     */
+    keywords?: string[];
+}
+/**
+ * Payload for finding relevant skills
+ */
+export interface FindRelevantSkillsPayload {
+    context: SkillContext;
+    limit?: number;
+}
+/**
+ * Result from skill injection into agent context.
+ * Contains the rendered prompt/instructions from a skill interaction.
+ */
+export interface InjectedSkill {
+    /**
+     * The skill/interaction name
+     */
+    name: string;
+    /**
+     * The skill's rendered instructions (from the interaction prompt)
+     */
+    instructions: string;
+    /**
+     * Tools related to this skill
+     */
+    related_tools?: string[];
+    /**
+     * UI module for rendering results
+     */
+    ui_module?: string;
+    /**
+     * Match score (0-1) indicating relevance
+     */
+    match_score?: number;
+}
+/**
+ * Result from generateTools activity with skills
+ */
+export interface ToolsWithSkills {
+    /**
+     * Array of tool definitions
+     */
+    tools: unknown[];
+    /**
+     * Skills injected based on context
+     */
+    injected_skills: InjectedSkill[];
+}

package/lib/types/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,KAAK,EAAE,OAAO,EAAE,CAAC;IAEjB;;OAEG;IACH,eAAe,EAAE,aAAa,EAAE,CAAC;CACpC"}

package/lib/types/store/activity-catalog.d.ts

@@ -0,0 +1,26 @@
+export type TsPropType = "string" | "number" | "boolean" | "record" | "object" | "array" | "enum" | "literal" | "union" | "promise" | "any" | "void";
+export interface ActivityTypeDefinition {
+    name: TsPropType;
+    value: string | boolean | number | null;
+    members?: ActivityPropertyDefinition[];
+    innerType?: ActivityTypeDefinition;
+    enum?: string[] | number[] | undefined;
+    union?: ActivityTypeDefinition[];
+}
+export interface ActivityPropertyDefinition {
+    name: string;
+    type: ActivityTypeDefinition;
+    optional: boolean;
+    doc?: string;
+}
+export interface ActivityDefinition {
+    name: string;
+    title: string;
+    doc?: string;
+    paramsType: string;
+    params: ActivityPropertyDefinition[];
+    returnType?: ActivityTypeDefinition | undefined;
+}
+export interface ActivityCatalog {
+    activities: ActivityDefinition[];
+}

package/lib/types/store/activity-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-catalog.d.ts","sourceRoot":"","sources":["../../../src/store/activity-catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAGrJ,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,UAAU,CAAC;IAOjB,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IAExC,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAEvC,SAAS,CAAC,EAAE,sBAAsB,CAAC;IAEnC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IAEvC,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,sBAAsB,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAElB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,EAAE,MAAM,CAAC;IAEd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,0BAA0B,EAAE,CAAC;IACrC,UAAU,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,kBAAkB,EAAE,CAAC;CACpC"}

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

@@ -0,0 +1,78 @@
+import { BaseObject } from "./common.js";
+import { ColumnLayout, ContentObjectTypeRef } from "./store.js";
+export declare enum CollectionStatus {
+    active = "active",
+    archived = "archived"
+}
+export interface CreateCollectionPayload {
+    name: string;
+    dynamic: boolean;
+    description?: string;
+    skip_head_sync?: boolean;
+    tags?: string[];
+    type?: string;
+    query?: Record<string, any>;
+    properties?: Record<string, any>;
+    parent?: string | null;
+    table_layout?: ColumnLayout[] | null;
+    allowed_types?: string[];
+    updated_by?: string;
+    shared_properties?: string[];
+}
+export interface CollectionItem extends BaseObject {
+    /**
+     * A flag to indicate if the collection is dynamic or static.
+     * If the collection is dynamic, the members are determined by a query using the query field.
+     * If the collection is static, the members are explicitly defined using the members array.
+     */
+    dynamic: boolean;
+    status: CollectionStatus;
+    type?: ContentObjectTypeRef;
+    /**
+     * A flag to indicate whether to track and sync member HEAD revisions.
+     * The default is to sync HEAD revisions for collection members (skip_head_sync: false)
+     */
+    skip_head_sync: boolean;
+    /**
+     * The parent collections if any.
+     * A collection can have multiple parents.
+     */
+    parents?: string[] | null;
+    /**
+     * The table layout to use for the collection.
+     * The layout defined in the type could serve as a fallback if not defined here.
+     */
+    table_layout?: ColumnLayout[];
+    /**
+     * The allowed types for the collection.
+     */
+    allowed_types?: string[];
+}
+export interface Collection extends CollectionItem {
+    properties: Record<string, any>;
+    query?: Record<string, any>;
+    security?: Record<string, 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.
+     */
+    shared_properties?: string[];
+}
+export interface StaticCollection extends Collection {
+    dynamic: false;
+    members: string[];
+    query: never;
+}
+export interface DynamicCollection extends Collection {
+    dynamic: true;
+}
+export interface CollectionSearchPayload {
+    parent?: string | null;
+    dynamic?: boolean;
+    status?: CollectionStatus;
+    limit?: number;
+    offset?: number;
+    name?: string;
+    type?: string;
+    types?: string[];
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../../src/store/collections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEhE,oBAAY,gBAAgB;IACxB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACxB;AAED,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,cAAe,SAAQ,UAAU;IAC9C;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IAEzB,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAE9B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc;IAC9C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAChD,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACjD,OAAO,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB"}

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

@@ -0,0 +1,22 @@
+/**
+ * Base interface for all domain objects in the system.
+ * Provides common properties shared across all business entities.
+ */
+export interface BaseObject {
+    /** Unique identifier for the object */
+    id: string;
+    /** Human-readable name or title */
+    name: string;
+    /** Optional detailed description of the object */
+    description?: string;
+    /** Optional array of categorization tags */
+    tags?: string[];
+    /** Identifier of the user who last modified the object */
+    updated_by: string;
+    /** Identifier of the user who created the object */
+    created_by: string;
+    /** ISO timestamp of when the object was created */
+    created_at: string;
+    /** ISO timestamp of when the object was last updated */
+    updated_at: string;
+}

package/lib/types/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;CAEtB"}

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

@@ -0,0 +1,120 @@
+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";
+/**
+ * Lightweight tool reference for activity payloads.
+ * References tools stored in GCP instead of embedding full tool definitions.
+ */
+export interface ToolReference {
+    storage_key: string;
+    tool_count: number;
+    stored_at: string;
+}
+/**
+ * Conversation state passed between workflow activities.
+ * Contains all context needed to continue a multi-turn agent conversation.
+ */
+export interface ConversationState {
+    /**
+     * A reference to the run that started the conversation
+     */
+    run: ExecutionRunDocRef;
+    /**
+     * The execution environment with provider info for LLM calls.
+     */
+    environment: string;
+    /**
+     * The options to use on the next call.
+     */
+    options: StatelessExecutionOptions;
+    /**
+     * The tools to call next.
+     */
+    tool_use?: ToolUse[];
+    /**
+     * The output of the this conversation step
+     */
+    output: CompletionResult[];
+    /**
+     * The token usage of the this conversation step
+     */
+    token_usage?: ExecutionTokenUsage;
+    /** If a sub workflow execution, contains the parent's info */
+    parent?: WorkflowAncestor;
+    /** Full ancestry chain from root to immediate parent (for hierarchical aggregation) */
+    ancestors: WorkflowAncestor[];
+    /** If part of a larger agentic workflow, task id of this task */
+    task_id?: string;
+    /** Stores the most recent plan for reference by plan-related tools */
+    plan?: Plan;
+    /** Debug mode (more logs and persisted artifacts) */
+    debug?: boolean;
+    /**
+     * Configuration for stripping large data from conversation history.
+     * Passed to llumiverse ExecutionOptions.stripImagesAfterTurns.
+     */
+    strip_options?: ConversationStripOptions;
+    /** Conversation artifacts base url */
+    conversation_artifacts_base_url?: string;
+    /** Reference to tools stored in GCP instead of embedding full tool definitions */
+    tool_reference?: ToolReference;
+    /** Names of currently active tools (base + unlocked). Tool definitions loaded from tool_reference. */
+    active_tool_names?: string[];
+    /** Skills that have been used in this conversation (for auto-syncing scripts and package installation) */
+    used_skills?: UsedSkill[];
+    /** All available skills from registered tool collections (for upfront hydration in sandbox) */
+    available_skills?: AvailableSkill[];
+    /** Whether to stream LLM responses to Redis (cached from project config) */
+    streaming_enabled?: boolean;
+    /**
+     * Active communication channels with their current state.
+     * Channels can be updated as conversation progresses (e.g., email threading info).
+     */
+    user_channels?: UserChannel[];
+    /**
+     * The resolved interaction execution info.
+     * Contains interaction ID, name, version, and environment details.
+     */
+    resolvedInteraction?: ResolvedInteractionExecutionInfo;
+    /**
+     * End conversation metadata set when end_conversation tool is called.
+     * Signals the workflow to terminate gracefully.
+     */
+    end_conversation?: {
+        final_result?: string;
+        status?: 'success' | 'failure';
+        reason?: string;
+    };
+    /**
+     * 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.
+     */
+    unlocked_tools?: string[];
+    /**
+     * Mapping of skill names to their related tools.
+     * When a skill is called, its related tools are added to unlocked_tools.
+     */
+    skill_tool_map?: Record<string, string[]>;
+}
+/** Skill metadata collected at workflow start for upfront sandbox hydration */
+export interface AvailableSkill {
+    /** Skill name (e.g., "analyze_data") - without the "learn_" prefix */
+    name: string;
+    /** Source URL of the skill collection (e.g., "https://tools.vertesia.io/api/skills/data-analysis") */
+    src: string;
+}
+/** Skill metadata tracked when a skill is used */
+export interface UsedSkill {
+    /** Skill name (e.g., "analyze_data") */
+    name: string;
+    /** Source URL of the skill collection (e.g., "https://tools.vertesia.io/api/skills/data-analysis") */
+    src: string;
+    /** Programming language (e.g., "python") */
+    language?: string;
+    /** Required packages (e.g., ["pandas", "numpy"]) */
+    packages?: string[];
+    /** System-level packages to install via sudo apt-get (e.g., ["poppler-utils"]) */
+    system_packages?: string[];
+}

package/lib/types/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":"AAAA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;OAEG;IACH,GAAG,EAAE,kBAAkB,CAAC;IAExB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,yBAAyB,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAElC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B,uFAAuF;IACvF,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAE9B,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sEAAsE;IACtE,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,aAAa,CAAC,EAAE,wBAAwB,CAAC;IAEzC,sCAAsC;IACtC,+BAA+B,CAAC,EAAE,MAAM,CAAC;IAEzC,kFAAkF;IAClF,cAAc,CAAC,EAAE,aAAa,CAAC;IAE/B,sGAAsG;IACtG,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B,0GAA0G;IAC1G,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;IAE1B,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;IAEpC,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAE9B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,gCAAgC,CAAC;IAEvD;;;OAGG;IACH,gBAAgB,CAAC,EAAE;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC3B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,sGAAsG;IACtG,GAAG,EAAE,MAAM,CAAC;CACf;AAED,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACtB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,sGAAsG;IACtG,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B"}

package/lib/types/store/doc-analyzer.d.ts

@@ -0,0 +1,140 @@
+import { WorkflowExecutionPayload, WorkflowRunStatus } from "./workflow.js";
+export interface PdfToRichtextOptions {
+    features: string[];
+    debug?: boolean;
+    [key: string]: any;
+}
+export interface PdfToRichTextWorkflowPayload extends Omit<WorkflowExecutionPayload, "vars"> {
+    vars: PdfToRichtextOptions;
+}
+/**
+ * Represents a image in a document that has been analyzed
+ */
+export interface DocImage {
+    id?: string;
+    page_number?: number;
+    description?: string;
+    is_meaningful?: boolean;
+    width?: number;
+    height?: number;
+}
+/**
+ * The export type formats for tables.
+ */
+export type ExportTableFormats = 'json' | 'csv' | 'xml';
+/**
+ * Represents a table in a document that has been analyzed
+ */
+export interface DocTable {
+    page_number?: number;
+    table_number?: number;
+    title?: string;
+    format: "application/csv" | "application/json";
+}
+/**
+ * Represents a table in a document that has been analyzed in CSV format
+ */
+export interface DocTableCsv extends DocTable {
+    format: "application/csv";
+    title?: string;
+    data: string;
+}
+/**
+ * Represents a table in a document that has been analyzed in JSON format
+ */
+export interface DocTableJson extends DocTable {
+    format: "application/json";
+    title?: string;
+    data: Object[];
+}
+/**
+ * Output format for document processing workflows
+ */
+export type DocProcessorOutputFormat = "xml" | "markdown";
+/**
+ * Represents a document analysis run status
+ */
+export interface DocAnalyzeRunStatusResponse extends WorkflowRunStatus {
+    progress?: DocAnalyzerProgress;
+    /** The output format being used for processing (markdown or xml) */
+    output_format?: DocProcessorOutputFormat;
+}
+export interface DocAnalyzerResultResponse {
+    document?: string;
+    tables?: DocTableCsv[] | DocTableJson[];
+    images?: DocImage[];
+    annotated?: string | null;
+}
+export interface DocAnalyzerProgress {
+    pages: DocAnalyzerProgressStatus;
+    images: DocAnalyzerProgressStatus;
+    tables: DocAnalyzerProgressStatus;
+    visuals: DocAnalyzerProgressStatus;
+    started_at?: number;
+    percent: number;
+    /** The output format being used for processing (markdown or xml) */
+    output_format?: DocProcessorOutputFormat;
+}
+interface DocAnalyzerProgressStatus {
+    total: number;
+    processed: number;
+    success: number;
+    failed: number;
+}
+/**
+ * Adapt Tables Parameters, part of the request
+ */
+export interface AdaptTablesParams {
+    /**
+     * JSON Schema to to convert the table into
+     */
+    target_schema: string;
+    /**
+     * Natural language description of the type item the table are composed of
+     */
+    item_name: string;
+    /**
+     * Natural language description of the type of table or item to convert
+     */
+    instructions?: string;
+    /**
+     * Format to return the data in (csv, json)
+     */
+    format?: "csv" | "json";
+    /**
+     * Process the table as a whole or by page
+     */
+    process_as?: "page" | "table";
+    /**
+     * Process the table as a CSV file
+     */
+    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
+ */
+export interface AdaptedTable {
+    comment?: string;
+    data: Record<string, any>[];
+}
+export {};

package/lib/types/store/doc-analyzer.d.ts.map

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