@vertesia/appgen-docs 1.5.0-dev.20260910.052912Z → 1.6.0-dev.20260912.110338Z

package/lib/docs/vertesia-client.d.ts

@@ -16,6 +16,7 @@ import type { AsyncExecutionResult } from '@vertesia/common';
 export type { EnableEnvironmentModelPayload, OrphanedAppInstallation } from '@vertesia/common';
 export { getOAuthPermissionScopes, Permission } from '@vertesia/common';
 export * from './client.js';
+export { default as DelegationGrantsApi } from './DelegationGrantsApi.js';
 export type { GroupsQueryOptions } from './GroupsApi.js';
 export * from './InteractionBase.js';
 export * from './InteractionOutput.js';
@@ -46,6 +47,7 @@ import { ApiKeysApi } from './ApiKeysApi.js';
 import AppsApi from './AppsApi.js';
 import AuditTrailApi from './AuditTrailApi.js';
 import CommandsApi from './CommandsApi.js';
+import DelegationGrantsApi from './DelegationGrantsApi.js';
 import EnvironmentsApi from './EnvironmentsApi.js';
 import { IamApi } from './IamApi.js';
 import InteractionsApi from './InteractionsApi.js';
@@ -213,6 +215,7 @@ export declare class VertesiaClient extends AbstractFetchClient<VertesiaClient>
     analytics: AnalyticsApi;
     auditTrail: AuditTrailApi;
     training: TrainingApi;
+    delegationGrants: DelegationGrantsApi;
     users: UsersApi;
     iam: IamApi;
     refs: RefsApi;
@@ -543,7 +546,7 @@ export default class InteractionsApi extends ApiTopic {
      * @param onChunk
      * @returns
      */
-    executeByName<ResultT = unknown, ParamsT = unknown>(nameWithTag: string, payload?: InteractionExecutionPayload, onChunk?: (chunk: string) => void): Promise<EnhancedInteractionExecutionResult<ResultT, ParamsT>>;
+    executeByName<ResultT = unknown, ParamsT = unknown>(nameWithTag: string, payload?: InteractionExecutionPayload, onChunk?: (chunk: string) => void, requestOptions?: IRequestParams): Promise<EnhancedInteractionExecutionResult<ResultT, ParamsT>>;
     /**
      * Execute an interaction in an workflow
      * @param payload
@@ -746,7 +749,7 @@ export default class SkillsApi extends ApiTopic {
 // @vertesia/client: RunsApi.d.ts
 // -----------------------------------------------------------------------------
 import type { ExecutionResponse } from '@llumiverse/common';
-import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import { ApiTopic, type ClientBase, type IRequestParams } from '@vertesia/api-fetch-client';
 import type { ComputeRunFacetPayload, ComputeRunFacetsResponse, ExecutionRunDocRef, ExecutionRunRef, FindPayload, FindRunResult, PopulatedExecutionRun, RunClonePayload, RunCreatePayload, RunListingFilters, RunListingQueryOptions, RunSearchPayload, ToolResultsPayload, UserMessagePayload } from '@vertesia/common';
 import { type EnhancedExecutionRun, type EnhancedInteractionExecutionResult } from './InteractionOutput.js';
 export interface FilterOption {
@@ -755,6 +758,7 @@ export interface FilterOption {
     count: number;
 }
 export type { ComputeRunFacetsResponse } from '@vertesia/common';
+type ResumeRequestOptions = Pick<IRequestParams, 'headers' | 'signal' | 'timeoutMs'>;
 export declare class RunsApi extends ApiTopic {
     constructor(parent: ClientBase);
     /**
@@ -787,19 +791,13 @@ export declare class RunsApi extends ApiTopic {
      * @param payload
      * @returns
      */
-    sendToolResults(payload: ToolResultsPayload, options?: {
-        timeoutMs?: number | false | null;
-        signal?: AbortSignal;
-    }): Promise<ExecutionResponse>;
+    sendToolResults(payload: ToolResultsPayload, options?: ResumeRequestOptions): Promise<ExecutionResponse>;
     /**
      *
      * @param payload
      * @returns
      */
-    sendUserMessage(payload: UserMessagePayload, options?: {
-        timeoutMs?: number | false | null;
-        signal?: AbortSignal;
-    }): Promise<ExecutionResponse>;
+    sendUserMessage(payload: UserMessagePayload, options?: ResumeRequestOptions): Promise<ExecutionResponse>;
     /**
      * Get the list of all runs facets
      * @param payload query payload to filter facet search
@@ -1150,7 +1148,7 @@ export declare class CollectionsApi extends ApiTopic {
 // @vertesia/client: store/AgentsApi.d.ts
 // -----------------------------------------------------------------------------
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
-import { type ActiveWorkstreamsQueryResult, type AgentArtifactContentResponse, type AgentArtifactUrlResponse, type AgentEvent, type AgentMessage, type AgentRun, type AgentRunDetailsStreamEvent, type AgentRunInternals, type AgentRunResponse, type BindRunWorkflowPayload, type CreateAgentRunPayload, type CreateProcessRunPayload, type ErrorAnalyticsResponse, type FirstResponseBehaviorAnalyticsResponse, type IngestAgentEventsResponse, type LatencyAnalyticsResponse, type ListAgentRunsQuery, type ListAgentRunsResponse, type ListWorkflowRunsResponse, type PostAgentRunUpdatePayload, type PostAgentRunUpdateResponse, type ProcessRun, type ProcessState, type PromptSizeAnalyticsResponse, type RecordAgentRunPayload, type RecordProcessRunPayload, type RunsByAgentAnalyticsResponse, type SearchAgentRunsQuery, type SearchAgentRunsResponse, type SignalAgentPayload, type SignalAgentResponse, type TerminateAgentRunResponse, type TimeToFirstResponseAnalyticsResponse, type TokenUsageAnalyticsResponse, type ToolAnalyticsResponse, type ToolParameterAnalyticsResponse, type TopPrincipalsAnalyticsResponse, type UpdateAgentArtifactContentPayload, type UpdateAgentArtifactContentResponse, type UpdateAgentRunStatusPayload, type WorkflowAnalyticsFilterOptionsResponse, type WorkflowAnalyticsSummaryQuery, type WorkflowAnalyticsSummaryResponse, type WorkflowAnalyticsTimeSeriesQuery, type WorkflowRunWithDetails, type WorkflowToolParametersQuery } from '@vertesia/common';
+import { type ActiveWorkstreamsQueryResult, type AgentArtifactContentResponse, type AgentArtifactUrlResponse, type AgentEvent, type AgentMessage, type AgentRun, type AgentRunDetailsStreamEvent, type AgentRunFeedbackPayload, type AgentRunFeedbackResponse, type AgentRunInternals, type AgentRunResponse, type BindRunWorkflowPayload, type CreateAgentRunPayload, type CreateProcessRunPayload, type ErrorAnalyticsResponse, type FirstResponseBehaviorAnalyticsResponse, type IngestAgentEventsResponse, type LatencyAnalyticsResponse, type ListAgentRunsQuery, type ListAgentRunsResponse, type ListWorkflowRunsResponse, type PostAgentRunUpdatePayload, type PostAgentRunUpdateResponse, type ProcessRun, type ProcessState, type PromptSizeAnalyticsResponse, type RecordAgentRunPayload, type RecordProcessRunPayload, type RunsByAgentAnalyticsResponse, type SearchAgentRunsQuery, type SearchAgentRunsResponse, type SignalAgentPayload, type SignalAgentResponse, type TerminateAgentRunResponse, type TimeToFirstResponseAnalyticsResponse, type TokenUsageAnalyticsResponse, type ToolAnalyticsResponse, type ToolParameterAnalyticsResponse, type TopPrincipalsAnalyticsResponse, type UpdateAgentArtifactContentPayload, type UpdateAgentArtifactContentResponse, type UpdateAgentRunStatusPayload, type WorkflowAnalyticsFilterOptionsResponse, type WorkflowAnalyticsSummaryQuery, type WorkflowAnalyticsSummaryResponse, type WorkflowAnalyticsTimeSeriesQuery, type WorkflowRunWithDetails, type WorkflowToolParametersQuery } from '@vertesia/common';
 export interface AgentRunStreamMessagesOptions {
     /** Resolve the stream when the root conversation becomes idle. Headless followers should opt in. */
     closeOnIdle?: boolean;
@@ -1194,6 +1192,15 @@ export declare class AgentsApi extends ApiTopic {
     list(query?: ListAgentRunsQuery): Promise<ListAgentRunsResponse>;
     listProcessRuns(query?: Omit<ListAgentRunsQuery, 'run_kind'>): Promise<ProcessRun[]>;
     private buildListQueryParams;
+    /**
+     * Rate an agent run: thumbs up or down, with an optional reason code and comment.
+     *
+     * `feedback_id` is the client's idempotency key: a retried request with the same id is a no-op.
+     * `status: 'replaced'` means an earlier rating by the same user on the same scope was
+     * superseded; `disabled` means this deployment does not record feedback. All answer 200 because
+     * a rating is never the user's error.
+     */
+    recordFeedback(id: string, payload: AgentRunFeedbackPayload): Promise<AgentRunFeedbackResponse>;
     /**
      * Search agent runs via Elasticsearch (full-text + filters).
      */
@@ -1293,6 +1300,7 @@ export declare class AgentsApi extends ApiTopic {
     getRunDetails(id: string, options?: {
         includeHistory?: boolean;
         hydratePayloads?: boolean;
+        from?: string;
     }): Promise<WorkflowRunWithDetails>;
     /**
      * Stream Temporal history events via SSE (handles continueAsNew).
@@ -1310,6 +1318,7 @@ export declare class AgentsApi extends ApiTopic {
     getChildDetails(id: string, childWorkflowId: string, options?: {
         includeHistory?: boolean;
         hydratePayloads?: boolean;
+        from?: string;
     }): Promise<WorkflowRunWithDetails>;
     /**
      * List artifacts for an agent run.
@@ -2644,7 +2653,7 @@ export {};
  */
 import type { ReasoningEffort } from '@llumiverse/common';
 import type { z } from 'zod';
-import type { AgentArtifactContentResponseSchema, AgentArtifactUrlResponseSchema, AgentRunArchiveStateSchema, AgentRunArtifactQuerySchema, AgentRunArtifactsQuerySchema, AgentRunArtifactUploadHeadersSchema, AgentRunDetailsQuerySchema, AgentRunSchema, AgentRunUpdatesQuerySchema, AgentRunUpdatesResponseSchema, CreateAgentRunPayloadSchema, CreateProcessRunByIdPayloadSchema, CreateProcessRunWithDefinitionPayloadSchema, CreateRunPayloadSchema, IngestAgentEventsPayloadSchema, IngestAgentEventsResponseSchema, ListAgentRunsQuerySchema, PostAgentRunUpdatePayloadSchema, PostAgentRunUpdateResponseSchema, SearchAgentRunsQuerySchema, SearchAgentRunsResponseSchema, SignalAgentResponseSchema, StreamAgentRunQuerySchema, TerminateAgentRunResponseSchema, UpdateAgentArtifactContentPayloadSchema, UpdateAgentArtifactContentResponseSchema } from '../api-schemas/agent-runs.js';
+import type { AgentArtifactContentResponseSchema, AgentArtifactUrlResponseSchema, AgentRunArchiveStateSchema, AgentRunArtifactQuerySchema, AgentRunArtifactsQuerySchema, AgentRunArtifactUploadHeadersSchema, AgentRunContradictionReasonSchema, AgentRunDetailsQuerySchema, AgentRunEvaluationRollupSchema, AgentRunEvaluationSchema, AgentRunFeedbackCountsSchema, AgentRunFeedbackEntrySchema, AgentRunFeedbackPayloadSchema, AgentRunFeedbackRatingSchema, AgentRunFeedbackReasonCodeSchema, AgentRunFeedbackResponseSchema, AgentRunFeedbackStatusSchema, AgentRunJudgeResultSchema, AgentRunSchema, AgentRunUpdatesQuerySchema, AgentRunUpdatesResponseSchema, CreateAgentRunPayloadSchema, CreateProcessRunByIdPayloadSchema, CreateProcessRunWithDefinitionPayloadSchema, CreateRunPayloadSchema, IngestAgentEventsPayloadSchema, IngestAgentEventsResponseSchema, ListAgentRunsEvaluationSeveritySchema, ListAgentRunsQuerySchema, PostAgentRunUpdatePayloadSchema, PostAgentRunUpdateResponseSchema, SearchAgentRunsQuerySchema, SearchAgentRunsResponseSchema, SignalAgentResponseSchema, StreamAgentRunQuerySchema, TerminateAgentRunResponseSchema, UpdateAgentArtifactContentPayloadSchema, UpdateAgentArtifactContentResponseSchema } from '../api-schemas/agent-runs.js';
 import type { AgentRunSearchHitSchema, AgentRunStatusSchema, AgentRunTypeSchema, RunKindSchema, RunTypeSchema } from '../api-schemas/app-lifecycle.js';
 import type { ProcessRunConfigSchema, ProcessRunTypeSchema } from '../api-schemas/process.js';
 import type { BindRunWorkflowPayloadSchema, RestartAgentRunPayloadSchema } from '../api-schemas/workflow-runs.js';
@@ -2654,6 +2663,7 @@ import type { AgentToolApprovalMode } from './agent-approval.js';
 import type { ProcessDefinitionBody, ProcessState } from './process.js';
 import type { ModelConfigChangedSignal, StopSignal, UserInputSignal } from './signals.js';
 import type { ConversationActivityState, ConversationFileBatchRef, ConversationFileRef, ConversationFileRemovedRef, WorkflowRunEvent } from './workflow.js';
+export * from './agent-run-values.js';
 export type AgentRunStatus = z.infer<typeof AgentRunStatusSchema>;
 export type AgentRunArchiveState = z.infer<typeof AgentRunArchiveStateSchema>;
 export type AgentRunType = z.infer<typeof AgentRunTypeSchema>;
@@ -2803,6 +2813,8 @@ export interface RecordAgentRunPayload<TData = Record<string, unknown>> extends
 export interface RecordProcessRunPayload<TData = Record<string, unknown>, TSource = RunSource> extends ProcessRunInputPayload<TData, TSource>, RecordRunWorkflowPayload {
     run_kind: 'process';
     run_type?: ProcessRunType;
+    schedule_id?: string;
+    type?: AgentRunType;
 }
 export type RecordRunPayload<TData = Record<string, unknown>, TSource = RunSource> = RecordAgentRunPayload<TData> | RecordProcessRunPayload<TData, TSource>;
 /**
@@ -2811,6 +2823,17 @@ export type RecordRunPayload<TData = Record<string, unknown>, TSource = RunSourc
  */
 export type BindRunWorkflowPayload = z.infer<typeof BindRunWorkflowPayloadSchema>;
 export type TerminateAgentRunResponse = z.infer<typeof TerminateAgentRunResponseSchema>;
+export type AgentRunFeedbackRating = z.infer<typeof AgentRunFeedbackRatingSchema>;
+export type AgentRunFeedbackReasonCode = z.infer<typeof AgentRunFeedbackReasonCodeSchema>;
+export type AgentRunFeedbackPayload = z.infer<typeof AgentRunFeedbackPayloadSchema>;
+export type AgentRunFeedbackStatus = z.infer<typeof AgentRunFeedbackStatusSchema>;
+export type AgentRunFeedbackCounts = z.infer<typeof AgentRunFeedbackCountsSchema>;
+export type AgentRunFeedbackResponse = z.infer<typeof AgentRunFeedbackResponseSchema>;
+export type AgentRunFeedbackEntry = z.infer<typeof AgentRunFeedbackEntrySchema>;
+export type AgentRunEvaluationRollup = z.infer<typeof AgentRunEvaluationRollupSchema>;
+export type AgentRunJudgeResult = z.infer<typeof AgentRunJudgeResultSchema>;
+export type AgentRunContradictionReason = z.infer<typeof AgentRunContradictionReasonSchema>;
+export type AgentRunEvaluation = z.infer<typeof AgentRunEvaluationSchema>;
 /**
  * Payload for updating an AgentRun's lifecycle and derived metadata.
  */
@@ -2842,6 +2865,11 @@ export interface UpdateAgentRunStatusPayload {
     last_archive_error?: string;
     sequence?: number;
     process_state?: ProcessState;
+    /**
+     * Fold of the run's turn evaluations, written by the conversation workflow. The server applies
+     * it atomically and ignores a rollup whose `seq` is not newer than the one it holds.
+     */
+    evaluation_rollup?: AgentRunEvaluationRollup;
 }
 export type SignalAgentPayload = UserInputSignal | StopSignal | ModelConfigChangedSignal | ConversationFileRef | ConversationFileRemovedRef | ConversationFileBatchRef | Record<string, unknown>;
 export type SignalAgentResponse = z.infer<typeof SignalAgentResponseSchema>;
@@ -2902,6 +2930,8 @@ export type AgentRunDetailsStreamEvent = {
     type: 'error';
     data: AgentRunDetailsErrorStreamEvent;
 };
+/** Evaluation severity filter values; `unrated` selects runs without an evaluation. */
+export type ListAgentRunsEvaluationSeverity = z.infer<typeof ListAgentRunsEvaluationSeveritySchema>;
 /**
  * Filters for listing agent runs.
  */
@@ -2947,7 +2977,6 @@ export type CreateProcessRunByIdPayload = z.infer<typeof CreateProcessRunByIdPay
 export type CreateProcessRunWithDefinitionPayload = z.infer<typeof CreateProcessRunWithDefinitionPayloadSchema>;
 export type CreateRunPayload = z.infer<typeof CreateRunPayloadSchema>;
 export type RestartAgentRunPayload = z.infer<typeof RestartAgentRunPayloadSchema>;
-export {};
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: store/collections.d.ts
@@ -3018,6 +3047,7 @@ export type UpdateCollectionPayload = z.infer<typeof UpdateCollectionPayloadSche
 // -----------------------------------------------------------------------------
 import type { z } from 'zod';
 import type { AdvanceProcessPayloadSchema, AnswerProcessTaskPayloadSchema, BranchDefinitionSchema, BranchJoinPolicySchema, CreateProcessTestSuitePayloadSchema, HumanTaskDefinitionSchema, JsonLogicRuleSchema, ListProcessDefinitionsQuerySchema, ListProcessTestRunsQuerySchema, NodeHistoryEntrySchema, ParallelCollectDefinitionSchema, ParallelCollectFieldSchema, ParallelCollectModeSchema, ParallelFailurePolicySchema, ProcessContextDefinitionSchema, ProcessContextResponseSchema, ProcessDefinitionFormatVersionSchema, ProcessDefinitionMetadataSchema, ProcessDefinitionRevisionInfoSchema, ProcessDefinitionStatusSchema, ProcessHistoryRefSchema, ProcessHistoryResponseSchema, ProcessNodeReturnsDefinitionSchema, ProcessNodeRunTypeSchema, ProcessNodeTypeSchema, ProcessResourcesDefinitionSchema, ProcessScriptInlineSourceSchema, ProcessScriptLanguageSchema, ProcessScriptResourceSchema, ProcessScriptSourceSchema, ProcessStateSchema, ProcessTestActorDecisionSchema, ProcessTestAssertionResultSchema, ProcessTestAssertionsSchema, ProcessTestChildTraceSchema, ProcessTestCoverageSchema, ProcessTestFixtureErrorSchema, ProcessTestFixtureResponseSchema, ProcessTestFixtureResultSchema, ProcessTestHumanActionSchema, ProcessTestInlineSubjectSchema, ProcessTestNodeFixtureSchema, ProcessTestResolvedSubjectSchema, ProcessTestRunSchema, ProcessTestRunStatusSchema, ProcessTestScenarioResultSchema, ProcessTestScenarioSchema, ProcessTestStoredSubjectSchema, ProcessTestSubjectSchema, ProcessTestSuiteSchema, ProcessTestTargetByIdSchema, ProcessTestTargetWithDefinitionSchema, ProcessTestVirtualActorSchema, PublishProcessDefinitionPayloadSchema, RetryProcessNodePayloadSchema, RevertProcessDefinitionPayloadSchema, StartProcessTestRunPayloadSchema, SubmitProcessTestRunPayloadSchema, TransitionDefinitionSchema, TransitionTriggerSchema, UpdateProcessTestScenarioPayloadSchema, UpdateProcessTestSuitePayloadSchema } from '../api-schemas/process.js';
+import type { ProcessAgentExecutionPolicySchema, ProcessAgentPhaseResetSchema, ProcessAgentToolInputContainsSchema, ProcessAgentToolPhaseSchema } from '../api-schemas/process-agent-policy.js';
 import type { JSONSchema } from '../json-schema.js';
 export type JsonLogicRule = z.infer<typeof JsonLogicRuleSchema>;
 export type ProcessDefinitionStatus = z.infer<typeof ProcessDefinitionStatusSchema>;
@@ -3032,6 +3062,10 @@ export type ProcessNodeRunType = z.infer<typeof ProcessNodeRunTypeSchema>;
 export type ParallelCollectMode = z.infer<typeof ParallelCollectModeSchema>;
 export type BranchJoinPolicy = z.infer<typeof BranchJoinPolicySchema>;
 export type ProcessDefinitionMetadata = z.infer<typeof ProcessDefinitionMetadataSchema>;
+export type ProcessAgentToolPhase = z.infer<typeof ProcessAgentToolPhaseSchema>;
+export type ProcessAgentToolInputContains = z.infer<typeof ProcessAgentToolInputContainsSchema>;
+export type ProcessAgentPhaseReset = z.infer<typeof ProcessAgentPhaseResetSchema>;
+export type ProcessAgentExecutionPolicy = z.infer<typeof ProcessAgentExecutionPolicySchema>;
 export type ProcessScriptLanguage = z.infer<typeof ProcessScriptLanguageSchema>;
 export type ProcessScriptInlineSource = z.infer<typeof ProcessScriptInlineSourceSchema>;
 export type ProcessScriptSource = z.infer<typeof ProcessScriptSourceSchema>;
@@ -3071,6 +3105,12 @@ export interface NodeDefinition {
     result_schema?: JSONSchema;
     prompt?: string;
     input?: Record<string, unknown>;
+    /**
+     * Whether interaction and custom-agent nodes receive the complete process
+     * context in addition to resolved `input`. Defaults to true for backward
+     * compatibility. Set false to keep specialist prompts input-only.
+     */
+    inherit_context?: boolean;
     config?: Record<string, unknown>;
     title?: string;
     description?: string;
@@ -3087,6 +3127,12 @@ export interface NodeDefinition {
     max_retries?: number;
     transitions?: TransitionDefinition[];
     tools?: string[];
+    /** Builtin system skills activated before the agent node's first model turn. */
+    initial_skills?: string[];
+    /** Execution-time tool denylist for the agent node's child conversation. */
+    excluded_tools?: string[];
+    /** Process-owned successful-tool phases and completion behavior for this agent node. */
+    agent_policy?: ProcessAgentExecutionPolicy;
     /**
      * Model id override for this node. If unset, falls back to the process
      * run's `config.model`, then to the project's default. Useful when a
@@ -3261,6 +3307,8 @@ export interface Queue {
 }
 export type WorkflowAncestor = z.infer<typeof WorkflowAncestorSchema>;
 export interface WorkflowExecutionBaseParams<T = Record<string, unknown>> {
+    /** Effective principal for private scheduled runs; server supplied. */
+    subject?: string;
     /**
      * The ref of the user who initiated the workflow.
      */

package/lib/docs/vertesia-common.d.ts

@@ -30,6 +30,7 @@ export * from './common.js';
 export * from './content-query.js';
 export * from './cost-analytics.js';
 export * from './data-platform.js';
+export type { CreateDelegationGrantPayload, DelegationGrant, DelegationGrantArray, DelegationTokenClaim, } from './delegation.js';
 export * from './email.js';
 export * from './embeddings.js';
 export * from './environment.js';
@@ -2473,6 +2474,7 @@ export type UpdateCollectionPayload = z.infer<typeof UpdateCollectionPayloadSche
 // -----------------------------------------------------------------------------
 import type { z } from 'zod';
 import type { AdvanceProcessPayloadSchema, AnswerProcessTaskPayloadSchema, BranchDefinitionSchema, BranchJoinPolicySchema, CreateProcessTestSuitePayloadSchema, HumanTaskDefinitionSchema, JsonLogicRuleSchema, ListProcessDefinitionsQuerySchema, ListProcessTestRunsQuerySchema, NodeHistoryEntrySchema, ParallelCollectDefinitionSchema, ParallelCollectFieldSchema, ParallelCollectModeSchema, ParallelFailurePolicySchema, ProcessContextDefinitionSchema, ProcessContextResponseSchema, ProcessDefinitionFormatVersionSchema, ProcessDefinitionMetadataSchema, ProcessDefinitionRevisionInfoSchema, ProcessDefinitionStatusSchema, ProcessHistoryRefSchema, ProcessHistoryResponseSchema, ProcessNodeReturnsDefinitionSchema, ProcessNodeRunTypeSchema, ProcessNodeTypeSchema, ProcessResourcesDefinitionSchema, ProcessScriptInlineSourceSchema, ProcessScriptLanguageSchema, ProcessScriptResourceSchema, ProcessScriptSourceSchema, ProcessStateSchema, ProcessTestActorDecisionSchema, ProcessTestAssertionResultSchema, ProcessTestAssertionsSchema, ProcessTestChildTraceSchema, ProcessTestCoverageSchema, ProcessTestFixtureErrorSchema, ProcessTestFixtureResponseSchema, ProcessTestFixtureResultSchema, ProcessTestHumanActionSchema, ProcessTestInlineSubjectSchema, ProcessTestNodeFixtureSchema, ProcessTestResolvedSubjectSchema, ProcessTestRunSchema, ProcessTestRunStatusSchema, ProcessTestScenarioResultSchema, ProcessTestScenarioSchema, ProcessTestStoredSubjectSchema, ProcessTestSubjectSchema, ProcessTestSuiteSchema, ProcessTestTargetByIdSchema, ProcessTestTargetWithDefinitionSchema, ProcessTestVirtualActorSchema, PublishProcessDefinitionPayloadSchema, RetryProcessNodePayloadSchema, RevertProcessDefinitionPayloadSchema, StartProcessTestRunPayloadSchema, SubmitProcessTestRunPayloadSchema, TransitionDefinitionSchema, TransitionTriggerSchema, UpdateProcessTestScenarioPayloadSchema, UpdateProcessTestSuitePayloadSchema } from '../api-schemas/process.js';
+import type { ProcessAgentExecutionPolicySchema, ProcessAgentPhaseResetSchema, ProcessAgentToolInputContainsSchema, ProcessAgentToolPhaseSchema } from '../api-schemas/process-agent-policy.js';
 import type { JSONSchema } from '../json-schema.js';
 export type JsonLogicRule = z.infer<typeof JsonLogicRuleSchema>;
 export type ProcessDefinitionStatus = z.infer<typeof ProcessDefinitionStatusSchema>;
@@ -2487,6 +2489,10 @@ export type ProcessNodeRunType = z.infer<typeof ProcessNodeRunTypeSchema>;
 export type ParallelCollectMode = z.infer<typeof ParallelCollectModeSchema>;
 export type BranchJoinPolicy = z.infer<typeof BranchJoinPolicySchema>;
 export type ProcessDefinitionMetadata = z.infer<typeof ProcessDefinitionMetadataSchema>;
+export type ProcessAgentToolPhase = z.infer<typeof ProcessAgentToolPhaseSchema>;
+export type ProcessAgentToolInputContains = z.infer<typeof ProcessAgentToolInputContainsSchema>;
+export type ProcessAgentPhaseReset = z.infer<typeof ProcessAgentPhaseResetSchema>;
+export type ProcessAgentExecutionPolicy = z.infer<typeof ProcessAgentExecutionPolicySchema>;
 export type ProcessScriptLanguage = z.infer<typeof ProcessScriptLanguageSchema>;
 export type ProcessScriptInlineSource = z.infer<typeof ProcessScriptInlineSourceSchema>;
 export type ProcessScriptSource = z.infer<typeof ProcessScriptSourceSchema>;
@@ -2526,6 +2532,12 @@ export interface NodeDefinition {
     result_schema?: JSONSchema;
     prompt?: string;
     input?: Record<string, unknown>;
+    /**
+     * Whether interaction and custom-agent nodes receive the complete process
+     * context in addition to resolved `input`. Defaults to true for backward
+     * compatibility. Set false to keep specialist prompts input-only.
+     */
+    inherit_context?: boolean;
     config?: Record<string, unknown>;
     title?: string;
     description?: string;
@@ -2542,6 +2554,12 @@ export interface NodeDefinition {
     max_retries?: number;
     transitions?: TransitionDefinition[];
     tools?: string[];
+    /** Builtin system skills activated before the agent node's first model turn. */
+    initial_skills?: string[];
+    /** Execution-time tool denylist for the agent node's child conversation. */
+    excluded_tools?: string[];
+    /** Process-owned successful-tool phases and completion behavior for this agent node. */
+    agent_policy?: ProcessAgentExecutionPolicy;
     /**
      * Model id override for this node. If unset, falls back to the process
      * run's `config.model`, then to the project's default. Useful when a
@@ -2716,6 +2734,8 @@ export interface Queue {
 }
 export type WorkflowAncestor = z.infer<typeof WorkflowAncestorSchema>;
 export interface WorkflowExecutionBaseParams<T = Record<string, unknown>> {
+    /** Effective principal for private scheduled runs; server supplied. */
+    subject?: string;
     /**
      * The ref of the user who initiated the workflow.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/appgen-docs",
-  "version": "1.5.0-dev.20260910.052912Z",
+  "version": "1.6.0-dev.20260912.110338Z",
   "description": "Generated SDK references and development guidance for Vertesia app agents",
   "type": "module",
   "main": "./lib/index.js",
@@ -17,11 +17,11 @@
   },
   "devDependencies": {
     "@types/node": "^24.13.3",
-    "typescript": "7.0.2",
-    "@vertesia/client": "1.5.0-dev.20260910.052912Z",
-    "@vertesia/common": "1.5.0-dev.20260910.052912Z",
-    "@vertesia/ui": "1.5.0-dev.20260910.052912Z",
-    "@vertesia/tsconfig": "0.1.0"
+    "@vertesia/client": "1.6.0-dev.20260912.110338Z",
+    "@vertesia/common": "1.6.0-dev.20260912.110338Z",
+    "@vertesia/tsconfig": "0.1.0",
+    "@vertesia/ui": "1.6.0-dev.20260912.110338Z",
+    "typescript": "7.0.2"
   },
   "repository": {
     "type": "git",
@@ -34,7 +34,7 @@
     "documentation",
     "app-development"
   ],
-  "gitHead": "95d481ca856012cd67b501b901dc365afeb7cf81",
+  "gitHead": "504e8df031c3950ec324c865385caf460b1c1cd7",
   "scripts": {
     "build": "pnpm run clean && tsc -p tsconfig.json && node ./scripts/generate-docs.mjs",
     "clean": "rimraf ./lib ./docs ./tsconfig.tsbuildinfo",