@hasura/promptql 2.0.0-alpha.34 → 2.0.0-alpha.35

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { C as CreateRoomMutationVariables, B as Bigint_Comparison_Exp, O as Order_By, S as StartThreadMutation, T as ThreadEventFragment, a as SendThreadMessageMutation, G as GetRoomsQueryVariables, R as RoomFragment, b as CancelAgentMessageMutationVariables, c as ThreadFragment, d as GetThreadsQueryVariables, e as SendThreadMessageMutationVariables, f as StartThreadMutationVariables, g as SearchWikiPagesQuery, h as SearchWikiPagesQueryVariables } from './graphql-BcfHC50n.mjs';
+import { C as CreateRoomMutationVariables, B as Bigint_Comparison_Exp, O as Order_By, S as StartThreadMutation, T as ThreadEventFragment, a as SendThreadMessageMutation, G as GetRoomsQueryVariables, R as RoomFragment, b as CancelAgentMessageMutationVariables, c as ThreadFragment, d as GetThreadsQueryVariables, e as SendThreadMessageMutationVariables, f as StartThreadMutationVariables, g as SearchWikiPagesQuery, h as SearchWikiPagesQueryVariables } from './graphql-Drrif9Kc.mjs';
 import { ApolloClient, Observable } from '@apollo/client';
 import * as graphql_ws from 'graphql-ws';
 
@@ -18,6 +18,7 @@ type ThreadEvent$1 = {
         message_id: string;
         user_id: PromptQlUserId;
         message: UserMessage;
+        provenance?: UserEventProvenance | null;
     };
 } | {
     ScheduledAgentTriggerEvent: {
@@ -99,6 +100,14 @@ type ThreadEvent$1 = {
 type PromptQlUserId = string;
 type ArtifactId = string;
 type TzWrapper = string;
+type UserEventProvenance = {
+    user: {};
+} | {
+    promptql: {
+        thread_id: ThreadId;
+    };
+};
+type ThreadId = string;
 type ScheduledAgentTriggerEventId = string;
 /**
  * A registered scheduled agent trigger ID
@@ -277,9 +286,13 @@ type AgentLoopUpdate = {
         skill: SkillType;
     };
 } | {
-    completed: {
+    checkpoint: {
         summary: string;
     };
+} | {
+    completed: {
+        summary?: string | null;
+    };
 } | {
     thread_summarized: {
         summary_text: string;
@@ -367,11 +380,20 @@ type AgentLoopActionLegacy = ({
     run_program: {
         entrypoint: string;
         package_name?: ProgramPackageName | null;
+        /**
+         * When set, exposed to the python program as `sys.argv[1:]`.
+         * Only effective when the resolved entrypoint is a `.py` file.
+         */
+        arguments?: string[] | null;
     };
 } | {
     responding_to_user: {
         message: string;
     };
+} | {
+    final_response: {
+        message: string;
+    };
 } | {
     read_wiki_page: {
         page_title: string;
@@ -408,6 +430,12 @@ type AgentLoopActionLegacy = ({
     mark_learnings_as_obsolete: {
         learning_block_id: LearningBlockId;
     };
+} | {
+    learning_block: {
+        user_facing_summary?: string | null;
+        learnings?: string | null;
+        obsolete_learning_block_ids?: LearningBlockId[];
+    };
 }) | {
     decide_next_steps: DecideNextStepsFields;
 };
@@ -439,7 +467,12 @@ type SkillType = "python_programming" | "react_programming" | "knowledge_explora
  */
 type AgentLoopTerminalAction = {
     done: {
-        message: string;
+        /**
+         * Current threads have `Some("response text")`.
+         * New threads after we introduce `FinalResponse` action
+         * will produce `None` (response moved to `FinalResponse`).
+         */
+        message?: string | null;
     };
 } | {
     decide_next_steps: {
@@ -447,6 +480,10 @@ type AgentLoopTerminalAction = {
         next_steps: string;
         with_skill?: SkillType | null;
     };
+} | {
+    checkpoint: {
+        summary: string;
+    };
 };
 /**
  * Actions the agent can perform.
@@ -508,11 +545,20 @@ type AgentLoopAction = {
     run_program: {
         entrypoint: string;
         package_name?: ProgramPackageName | null;
+        /**
+         * When set, exposed to the python program as `sys.argv[1:]`.
+         * Only effective when the resolved entrypoint is a `.py` file.
+         */
+        arguments?: string[] | null;
     };
 } | {
     responding_to_user: {
         message: string;
     };
+} | {
+    final_response: {
+        message: string;
+    };
 } | {
     read_wiki_page: {
         page_title: string;
@@ -549,11 +595,163 @@ type AgentLoopAction = {
     mark_learnings_as_obsolete: {
         learning_block_id: LearningBlockId;
     };
+} | {
+    learning_block: {
+        user_facing_summary?: string | null;
+        learnings?: string | null;
+        obsolete_learning_block_ids?: LearningBlockId[];
+    };
 };
 /**
  * Intermediate updates emitted during action execution.
+ *
+ * Union of the original unversioned shape and a newer versioned shape.
+ * Current emitters produce only the [`AgentLoopActionUpdateUnversioned`]
+ * variants; [`AgentLoopActionUpdateVersioned`] is scaffolded so consumers
+ * are ready for a future emission switch without a second migration.
+ *
+ * Serialization is transparent — there's no extra wrapper in the on-disk
+ * JSON. Deserialization discriminates on the presence of a top-level
+ * `version` field: present → [`AgentLoopActionUpdateVersioned`], absent →
+ * [`AgentLoopActionUpdateUnversioned`].
+ */
+type AgentLoopActionUpdate = AgentLoopActionUpdateVersioned | AgentLoopActionUpdateUnversioned;
+/**
+ * Versioned shape of [`AgentLoopActionUpdate`]. Recognized by
+ * deserializers and consumers but not yet produced by any emitter.
+ */
+type AgentLoopActionUpdateVersioned = {
+    program_run_event: ProgramRunEvent;
+};
+type ProgramRunEvent = RunStarted | StepExecutionStarted | DataArtifactUpdated | OutputEmitted | CodeError | SqlError | SqlExecuteStarted | SqlExecuteCompleted | BuildError | ArtifactError | InternalError | PipelineProgress | ShelfTransactionOpened | ShelfTransactionSuspended | StepExecutionFinished | RunFinished | LlmUsageEvent;
+type RunStarted = {
+    type: "RunStarted";
+} & RunStartedV1;
+type StepExecutionStarted = {
+    type: "StepExecutionStarted";
+} & StepExecutionStartedV1;
+type RunStepDetails = PythonRunStepDetails | SqlRunStepDetails | UiBuildRunStepDetails | PipelineRunStepDetails;
+/**
+ * A unique identifier for a `PromptQL` Program
+ */
+type ProgramId = string;
+type DataArtifactUpdated = {
+    type: "DataArtifactUpdated";
+} & DataArtifactUpdatedV1;
+type ArtifactType = "table" | "text" | "visualization" | "automation" | "python_code" | "python_package" | "html" | "file";
+type OutputEmitted = {
+    type: "OutputEmitted";
+} & OutputEmittedV1;
+type CodeError = {
+    type: "CodeError";
+} & CodeErrorV1;
+type SqlError = {
+    type: "SqlError";
+} & SqlErrorV1;
+type SqlExecuteStarted = {
+    type: "SqlExecuteStarted";
+} & SqlExecuteStartedV1;
+type SqlQueryId = string;
+/**
+ * A SQL query string.
+ */
+type Sql = string;
+type SqlExecuteCompleted = {
+    type: "SqlExecuteCompleted";
+} & SqlExecuteCompletedV1;
+type ProgramRunSqlExecuteOutcome = {
+    rows_returned: number;
+    duration_ms: number;
+    type: "Success";
+} | {
+    duration_ms: number;
+    type: "Timeout";
+} | {
+    errored_after_ms: number;
+    error_type: SqlErrorType;
+    type: "Error";
+};
+/**
+ * Whether a SQL error was caused by the user (bad SQL) or by internal infrastructure.
+ */
+type SqlErrorType = {
+    message: string;
+    type: "user";
+} | {
+    message: string;
+    type: "internal";
+};
+type BuildError = {
+    type: "BuildError";
+} & BuildErrorV1;
+type ArtifactError = {
+    type: "ArtifactError";
+} & ArtifactErrorV1;
+/**
+ * Internal error event for capturing unusual internal failures
+ * (e.g., python-runtime crashes, non-build errors in UI build, etc.)
+ * This is distinct from user-facing errors like `CodeError` or `BuildError`.
+ */
+type InternalError = {
+    type: "InternalError";
+} & InternalErrorV1;
+/**
+ * Pipeline progress event for tracking pipeline execution state
+ * This event is emitted after each batch is processed and allows
+ * the pipeline to resume from where it left off
+ */
+type PipelineProgress = {
+    type: "PipelineProgress";
+} & (PipelineProgressV1 | PipelineProgressV2);
+type TransactionId = string;
+type ShelfSchemaName = string;
+/**
+ * Source state for pipeline progress, varies by source type
+ */
+type PipelineSourceState = {
+    rows_handled: number;
+    type: "sql-rows";
+} | {
+    state: unknown;
+    type: "python-state";
+};
+/**
+ * Emitted when the pipeline successfully opens a new shelf transaction.
+ * Carries the transaction ID so consumers can track or resume the job.
+ */
+type ShelfTransactionOpened = {
+    type: "ShelfTransactionOpened";
+} & ShelfTransactionOpenedV1;
+/**
+ * Emitted when a pipeline step finishes with an error while a shelf transaction
+ * is still open. The transaction ID can be used with the shelf-resume sink to
+ * continue from where the pipeline left off.
+ */
+type ShelfTransactionSuspended = {
+    type: "ShelfTransactionSuspended";
+} & ShelfTransactionSuspendedV1;
+type StepExecutionFinished = {
+    type: "StepExecutionFinished";
+} & StepExecutionFinishedV1;
+type RunFinished = {
+    type: "RunFinished";
+} & RunFinishedV1;
+type RunFinishedOutcome = {
+    type: "Success";
+} | {
+    error: string;
+    type: "Error";
+} | {
+    type: "UserCancelled";
+};
+type LlmUsageEvent = {
+    type: "LlmUsage";
+} & LlmUsageEventV1;
+/**
+ * Unversioned shape of [`AgentLoopActionUpdate`]. This is what current
+ * emitters produce and what persisted events on disk use.
  */
-type AgentLoopActionUpdate = {
+type AgentLoopActionUpdateUnversioned = {
     code_output: {
         output: string;
     };
@@ -586,7 +784,7 @@ type AgentLoopActionUpdate = {
         usage: LlmUsage;
     };
 };
-type ArtifactType = "text" | "table" | "visualization" | "html" | "file";
+type RuntimeArtifactType = "text" | "table" | "visualization" | "html" | "file";
 type ArtifactDataPreview = {
     Table: {
         total_row_count: number;
@@ -595,11 +793,6 @@ type ArtifactDataPreview = {
         }[];
     };
 };
-type SqlQueryId = string;
-/**
- * A SQL query string.
- */
-type Sql = string;
 type SqlExecuteOutcome = {
     rows_returned: number;
     duration_ms: number;
@@ -612,16 +805,6 @@ type SqlExecuteOutcome = {
     error: SqlErrorType;
     type: "error";
 };
-/**
- * Whether a SQL error was caused by the user (bad SQL) or by internal infrastructure.
- */
-type SqlErrorType = {
-    message: string;
-    type: "user";
-} | {
-    message: string;
-    type: "internal";
-};
 /**
  * The final result of executing an action.
  */
@@ -640,6 +823,9 @@ type AgentLoopActionResult = {
 } | {
     message: string;
     agent_loop_action_result_type: "message_sent";
+} | {
+    message: string;
+    agent_loop_action_result_type: "final_response_sent";
 } | {
     package_name: ProgramPackageName;
     agent_loop_action_result_type: "program_created";
@@ -717,6 +903,11 @@ type AgentLoopActionResult = {
 } | {
     learning_block_id: LearningBlockId;
     agent_loop_action_result_type: "learning_block_marked_as_obsolete";
+} | {
+    proposed_block_id?: LearningBlockId | null;
+    marked_obsolete_ids?: LearningBlockId[];
+    failed_obsolete_ids?: LearningBlockId[];
+    agent_loop_action_result_type: "learning_block_completed";
 };
 /**
  * The markdown content of block or section in a wiki page
@@ -1467,7 +1658,6 @@ type ProgrammerUpdate = {
 type ShelfUpdate = {
     v1: ShelfUpdateV1;
 };
-type TransactionId = string;
 type ShelfActionEvent = ("Started" | "Completed") | {
     RowsInserted: {
         row_count: number;
@@ -1935,6 +2125,13 @@ type SocialFeedRatingUpdate = {
         llm_usage?: SocialFeedRatingLlmUsage | null;
     };
 };
+type ExecuteProgramRequestProvenance = {
+    Api: {};
+} | {
+    Artifact: {
+        artifact_reference: ArtifactReference1;
+    };
+};
 /**
  * Versioned update emitted by an `ExecuteProgramResponse` thread event.
  */
@@ -1947,98 +2144,6 @@ type ProgramExecuteUpdate = {
         outcome: ProgramExecuteOutcome;
     };
 };
-type ProgramRunEvent = RunStarted | StepExecutionStarted | DataArtifactUpdated | OutputEmitted | CodeError | SqlError | SqlExecuteStarted | SqlExecuteCompleted | BuildError | ArtifactError | InternalError | PipelineProgress | StepExecutionFinished | RunFinished | LlmUsageEvent;
-type RunStarted = {
-    type: "RunStarted";
-} & RunStartedV1;
-type StepExecutionStarted = {
-    type: "StepExecutionStarted";
-} & StepExecutionStartedV1;
-type RunStepDetails = PythonRunStepDetails | SqlRunStepDetails | UiBuildRunStepDetails | PipelineRunStepDetails;
-/**
- * A unique identifier for a `PromptQL` Program
- */
-type ProgramId = string;
-type DataArtifactUpdated = {
-    type: "DataArtifactUpdated";
-} & DataArtifactUpdatedV1;
-type ArtifactType2 = "table" | "text" | "visualization" | "automation" | "python_code" | "python_package" | "html" | "file";
-type OutputEmitted = {
-    type: "OutputEmitted";
-} & OutputEmittedV1;
-type CodeError = {
-    type: "CodeError";
-} & CodeErrorV1;
-type SqlError = {
-    type: "SqlError";
-} & SqlErrorV1;
-type SqlExecuteStarted = {
-    type: "SqlExecuteStarted";
-} & SqlExecuteStartedV1;
-type SqlExecuteCompleted = {
-    type: "SqlExecuteCompleted";
-} & SqlExecuteCompletedV1;
-type SqlExecuteOutcome2 = {
-    rows_returned: number;
-    duration_ms: number;
-    type: "Success";
-} | {
-    duration_ms: number;
-    type: "Timeout";
-} | {
-    errored_after_ms: number;
-    error_type: SqlErrorType;
-    type: "Error";
-};
-type BuildError = {
-    type: "BuildError";
-} & BuildErrorV1;
-type ArtifactError = {
-    type: "ArtifactError";
-} & ArtifactErrorV1;
-/**
- * Internal error event for capturing unusual internal failures
- * (e.g., python-runtime crashes, non-build errors in UI build, etc.)
- * This is distinct from user-facing errors like `CodeError` or `BuildError`.
- */
-type InternalError = {
-    type: "InternalError";
-} & InternalErrorV1;
-/**
- * Pipeline progress event for tracking pipeline execution state
- * This event is emitted after each batch is processed and allows
- * the pipeline to resume from where it left off
- */
-type PipelineProgress = {
-    type: "PipelineProgress";
-} & (PipelineProgressV1 | PipelineProgressV2);
-/**
- * Source state for pipeline progress, varies by source type
- */
-type PipelineSourceState = {
-    rows_handled: number;
-    type: "sql-rows";
-} | {
-    state: unknown;
-    type: "python-state";
-};
-type StepExecutionFinished = {
-    type: "StepExecutionFinished";
-} & StepExecutionFinishedV1;
-type RunFinished = {
-    type: "RunFinished";
-} & RunFinishedV1;
-type RunFinishedOutcome = {
-    type: "Success";
-} | {
-    error: string;
-    type: "Error";
-} | {
-    type: "UserCancelled";
-};
-type LlmUsageEvent = {
-    type: "LlmUsage";
-} & LlmUsageEventV1;
 /**
  * The outcome of a program execution.
  */
@@ -2053,9 +2158,37 @@ type ProgramExecuteOutcome = {
 } | {
     server_cancelled: {};
 } | {
-    interrupted_due_to_new_trigger: {};
-};
-/**
+    interrupted_due_to_new_trigger: {
+        /**
+         * The trigger that caused the interruption. Optional only for backwards compatibility.
+         * New events will have this set.
+         */
+        trigger?: ProgramExecutionTriggerInterruption | null;
+    };
+};
+/**
+ * What interrupted a running program execution.
+ */
+type ProgramExecutionTriggerInterruption = {
+    user_message: {
+        /**
+         * A unique index for a user message in a thread
+         */
+        message_id: string;
+    };
+} | {
+    scheduled_agent_trigger_event: {
+        scheduled_agent_trigger_event_id: ScheduledAgentTriggerEventId;
+    };
+} | {
+    execute_program_request: {
+        /**
+         * A unique identifier for an execute program request in a thread
+         */
+        request_id: string;
+    };
+};
+/**
  * A chat message sent by a user
  */
 interface UserMessage {
@@ -2162,17 +2295,134 @@ interface ResponseTruncation {
      */
     total_bytes: number;
 }
-interface ArtifactUpdate {
-    identifier: string;
+interface RunStartedV1 {
+    version: "V1";
+}
+interface StepExecutionStartedV1 {
+    step_index: number;
+    step: RunStepDetails;
+    version: "V1";
+}
+interface PythonRunStepDetails {
+    other_program_id?: ProgramId | null;
+    file: string;
+    type: "PythonRunStepDetails";
+}
+interface SqlRunStepDetails {
+    other_program_id?: ProgramId | null;
+    file: string;
+    type: "SqlRunStepDetails";
+}
+interface UiBuildRunStepDetails {
+    other_program_id?: ProgramId | null;
+    app_tsx: string;
+    app_css: string;
+    type: "UiBuildRunStepDetails";
+}
+interface PipelineRunStepDetails {
+    type: "PipelineRunStepDetails";
+}
+interface DataArtifactUpdatedV1 {
+    step_index: number;
+    name: string;
     title: string;
+    artifact: ArtifactReference1;
     artifact_type: ArtifactType;
-    data?: ArtifactDataPreview | null;
-    artifact_reference: ArtifactReference1;
+    version: "V1";
 }
 interface ArtifactReference1 {
     artifact_id: ArtifactId;
     version: number;
 }
+interface OutputEmittedV1 {
+    step_index: number;
+    output: string;
+    version: "V1";
+}
+interface CodeErrorV1 {
+    step_index: number;
+    error: string;
+    version: "V1";
+}
+interface SqlErrorV1 {
+    step_index: number;
+    error: string;
+    version: "V1";
+}
+interface SqlExecuteStartedV1 {
+    step_index: number;
+    sql_query_id: SqlQueryId;
+    sql: Sql;
+    is_streaming: boolean;
+    version: "V1";
+}
+interface SqlExecuteCompletedV1 {
+    step_index: number;
+    sql_query_id: SqlQueryId;
+    outcome: ProgramRunSqlExecuteOutcome;
+    pushdown_mode: string;
+    version: "V1";
+}
+interface BuildErrorV1 {
+    step_index: number;
+    error: string;
+    version: "V1";
+}
+interface ArtifactErrorV1 {
+    step_index: number;
+    error: string;
+    version: "V1";
+}
+interface InternalErrorV1 {
+    step_index: number;
+    error: string;
+    version: "V1";
+}
+interface PipelineProgressV1 {
+    step_index: number;
+    transaction_id?: TransactionId | null;
+    schema_name?: ShelfSchemaName | null;
+    rows_handled: number;
+    version: "V1";
+}
+interface PipelineProgressV2 {
+    step_index: number;
+    transaction_id?: TransactionId | null;
+    schema_name?: ShelfSchemaName | null;
+    source_state: PipelineSourceState;
+    version: "V2";
+}
+interface ShelfTransactionOpenedV1 {
+    step_index: number;
+    transaction_id: TransactionId;
+    version: "V1";
+}
+interface ShelfTransactionSuspendedV1 {
+    step_index: number;
+    transaction_id: TransactionId;
+    version: "V1";
+}
+interface StepExecutionFinishedV1 {
+    step_index: number;
+    error?: string | null;
+    version: "V1";
+}
+interface RunFinishedV1 {
+    outcome: RunFinishedOutcome;
+    version: "V1";
+}
+interface LlmUsageEventV1 {
+    step_index: number;
+    usage: LlmUsage;
+    version: "V1";
+}
+interface ArtifactUpdate {
+    identifier: string;
+    title: string;
+    artifact_type: RuntimeArtifactType;
+    data?: ArtifactDataPreview | null;
+    artifact_reference: ArtifactReference1;
+}
 /**
  * Definition of a wiki page
  */
@@ -2515,7 +2765,7 @@ interface BuiltUi {
 interface ArtifactUpdate1 {
     identifier: string;
     title: string;
-    artifact_type: ArtifactType;
+    artifact_type: RuntimeArtifactType;
     data?: ArtifactDataPreview | null;
     artifact_reference: ArtifactReference1;
 }
@@ -2831,115 +3081,33 @@ interface SocialFeedRatingLlmUsage {
  * The payload of an `ExecuteProgramRequest` thread event.
  */
 interface ExecuteProgramRequestData {
-    package_name: ProgramPackageName;
+    /**
+     * `Some(pkg)`: run the named saved program package's `entrypoint`.
+     * `None`: run the `entrypoint` file directly out of the thread's
+     * workspace — i.e. a file the agent has written via `WriteFile`
+     * actions in this thread. The runner reconstructs the workspace
+     * from the thread's events and looks the entrypoint up there.
+     */
+    package_name?: ProgramPackageName | null;
     entrypoint?: string | null;
+    /**
+     * When non-empty, exposed as `sys.argv[1:]` of the program. Only
+     * legal when the entrypoint resolves to a single Python step;
+     * `run_config_for_entrypoint` rejects non-empty arguments for
+     * `.run.json` and `.sql` entrypoints with a descriptive error
+     * that surfaces as a thread-level `Errored` outcome.
+     */
+    arguments?: string[] | null;
     uploads: UserUpload[];
     timezone: TzWrapper;
-}
-interface RunStartedV1 {
-    version: "V1";
-}
-interface StepExecutionStartedV1 {
-    step_index: number;
-    step: RunStepDetails;
-    version: "V1";
-}
-interface PythonRunStepDetails {
-    other_program_id?: ProgramId | null;
-    file: string;
-    type: "PythonRunStepDetails";
-}
-interface SqlRunStepDetails {
-    other_program_id?: ProgramId | null;
-    file: string;
-    type: "SqlRunStepDetails";
-}
-interface UiBuildRunStepDetails {
-    other_program_id?: ProgramId | null;
-    app_tsx: string;
-    app_css: string;
-    type: "UiBuildRunStepDetails";
-}
-interface PipelineRunStepDetails {
-    type: "PipelineRunStepDetails";
-}
-interface DataArtifactUpdatedV1 {
-    step_index: number;
-    name: string;
-    title: string;
-    artifact: ArtifactReference1;
-    artifact_type: ArtifactType2;
-    version: "V1";
-}
-interface OutputEmittedV1 {
-    step_index: number;
-    output: string;
-    version: "V1";
-}
-interface CodeErrorV1 {
-    step_index: number;
-    error: string;
-    version: "V1";
-}
-interface SqlErrorV1 {
-    step_index: number;
-    error: string;
-    version: "V1";
-}
-interface SqlExecuteStartedV1 {
-    step_index: number;
-    sql_query_id: SqlQueryId;
-    sql: Sql;
-    is_streaming: boolean;
-    version: "V1";
-}
-interface SqlExecuteCompletedV1 {
-    step_index: number;
-    sql_query_id: SqlQueryId;
-    outcome: SqlExecuteOutcome2;
-    pushdown_mode: string;
-    version: "V1";
-}
-interface BuildErrorV1 {
-    step_index: number;
-    error: string;
-    version: "V1";
-}
-interface ArtifactErrorV1 {
-    step_index: number;
-    error: string;
-    version: "V1";
-}
-interface InternalErrorV1 {
-    step_index: number;
-    error: string;
-    version: "V1";
-}
-interface PipelineProgressV1 {
-    step_index: number;
-    transaction_id?: TransactionId | null;
-    rows_handled: number;
-    version: "V1";
-}
-interface PipelineProgressV2 {
-    step_index: number;
-    transaction_id?: TransactionId | null;
-    source_state: PipelineSourceState;
-    version: "V2";
-}
-interface StepExecutionFinishedV1 {
-    step_index: number;
-    error?: string | null;
-    version: "V1";
-}
-interface RunFinishedV1 {
-    outcome: RunFinishedOutcome;
-    version: "V1";
-}
-interface LlmUsageEventV1 {
-    step_index: number;
-    usage: LlmUsage;
-    version: "V1";
+    /**
+     * A natural language description of the purpose of invoking this program
+     */
+    description?: string | null;
+    /**
+     * What entity created this request
+     */
+    request_provenance?: ExecuteProgramRequestProvenance | null;
 }
 
 /**
@@ -3137,7 +3305,7 @@ type ArtifactMetadata = {
     version: number;
     title: string;
     description: string | null;
-    artifact_type: ArtifactType2;
+    artifact_type: ArtifactType;
     user_id: string;
     metadata: unknown;
     project_id: string;
@@ -3227,7 +3395,12 @@ declare function isInteractionAnalyzing(events: ThreadEvent[], skipAnalysis?: bo
 type SearchWikiPagesResult = NonNullable<SearchWikiPagesQuery["admin_wiki_search"]>;
 type WikiPageNamespace = "guide" | "regular";
 type WikiPageItem = WikiPageV1 & {
-    page_id: string;
+    /**
+     * The stable identifier of the wiki page. Use this when updating a page,
+     * since it does not change when the page is renamed.
+     */
+    id: string;
+    slug: string;
     created_at: string;
     last_modified_at?: string | null | undefined;
     /**
@@ -3248,7 +3421,12 @@ type WikiPageItem = WikiPageV1 & {
     definition?: string | null;
 };
 type WikiPageDetail = WikiPageV1 & {
-    page_id: string;
+    /**
+     * The stable identifier of the wiki page. Use this when updating a page,
+     * since it does not change when the page is renamed.
+     */
+    id: string;
+    slug: string;
     created_at: string;
     last_modified_at?: string | null | undefined;
 };
@@ -3259,9 +3437,19 @@ type ListWikiPageArgs = {
     include_stub?: boolean;
     offset?: number;
     limit?: number;
-    order_by?: "created_at" | "last_modified_at" | "page_id";
+    order_by?: "created_at" | "last_modified_at" | "slug";
     ordering?: Order_By;
 };
+/**
+ * Input arguments for creating a wiki page.
+ */
+type CreateWikiPageArgs = WikiPageV1 & {
+    slug?: string;
+};
+/**
+ * Input arguments for updating a wiki page.
+ */
+type UpdateWikiContentArgs = Partial<WikiPageV1>;
 /**
  * List wiki pages of the current project.
  */
@@ -3274,6 +3462,18 @@ declare function searchWikiPages(client: ApolloClient, variables: SearchWikiPage
  * Get wiki page by id.
  */
 declare function getWikiPage(client: ApolloClient, project_id: string, namespace: string, id: string): Promise<WikiPageDetail | null | undefined>;
+/**
+ * Create a wiki page with content.
+ */
+declare function createWikiPage(client: ApolloClient, { slug, ...others }: CreateWikiPageArgs): Promise<string | undefined>;
+/**
+ * Update a wiki page with content.
+ */
+declare function updateWikiPage(client: ApolloClient, id: string, content: UpdateWikiContentArgs): Promise<string | undefined>;
+/**
+ * Delete a wiki page by id.
+ */
+declare function deleteWikiPage(client: ApolloClient, id: string): Promise<string | undefined>;
 
 /**
  * A low-level API class for PromptQL.
@@ -3411,6 +3611,18 @@ declare class Wiki {
      * Get a PromptQL wiki page by primary keys.
      */
     get(namespace: WikiPageNamespace, id: string): Promise<WikiPageDetail | null | undefined>;
+    /**
+     * Create a wiki page with content.
+     */
+    create(args: CreateWikiPageArgs): Promise<string | undefined>;
+    /**
+     * Update a wiki page with content.
+     */
+    update(id: string, args: UpdateWikiContentArgs): Promise<string | undefined>;
+    /**
+     * Delete a wiki page by ID.
+     */
+    delete(id: string): Promise<string | undefined>;
 }
 
 /**
@@ -3629,4 +3841,4 @@ declare function getThreadEventMessageId(event: ThreadEvent$1 | undefined): stri
  */
 declare function buildPromptQLUrl(fqdn: string): string;
 
-export { type AgentGeneratedResponse, type AgentLearningUpdate, type AgentLoopAction, type AgentLoopActionLegacy, type AgentLoopActionResult, type AgentLoopActionUpdate, type AgentLoopTerminalAction, type AgentLoopUpdate, type AgentTrigger, type AgentUpdate, type AgentUpdateContent, type ApolloClientOptions, type ArtifactDataPreview, type ArtifactError, type ArtifactErrorV1, type ArtifactId, type ArtifactMetadata, type ArtifactReference, type ArtifactReference1, type ArtifactType, type ArtifactType2, type ArtifactUpdate, type ArtifactUpdate1, type AssumptionFactCheck, type BuildError, type BuildErrorV1, type BuiltUi, type BuiltUi1, CancelAgentMessageMutationVariables, type CheckedAssumption, type CheckedTopic, type CodeBlock, type CodeError, type CodeErrorV1, type CodeExecutionComplete, type CodeOutputAnalysis, type CodeOutputAnalyzed, type ComponentResponse, type ComponentResponse1, type ComponentResponse2, type ComponentResponse3, type ComponentResponse4, type ComponentResponse5, type ConfidenceAnalysis, type ConfidenceAnalysisLlmUsage, type ConfidenceAnalysisUpdate, type ContextExplorerCompleted, type ContextExplorerStarted, type ContextExplorerUpdate, type CopyFileEntry, type CreateRoomArguments, type DataArtifactUpdated, type DataArtifactUpdatedV1, type DecideNextStepsFields, type EventOfKind, type ExecuteProgramRequestData, type ExternalKnowledgeExplorerAttempt, type ExternalKnowledgeExplorerAttempt1, type ExternalKnowledgeSummary, type FactSource, type FederatedWikiName, type GeneratedCode, type GeneratedFile, type GeneratedResponse, type GeneratedUiCode, type GetThreadEventOptions, GetThreadsQueryVariables, type IPromptQLSdk, type InteractionDecision, type InteractionDecisionAccept, type InteractionDecisionDecline, type InteractionDecisionUpdate, type InteractionFinishedEvent, type InteractionFinishedUpdate, type InteractionOutcome, type InteractionOutcomeStatus, type InteractionUpdate, type InternalError, type InternalErrorV1, type InternalUpdate, type InterruptedByTrigger, type KeysOfUnion, type LearningBlockId, type LearningSuggestion, type LearningSuggestionUpdate, type LearningSuggestionUpdateV1, type ListWikiPageArgs, type LlmResponse, type LlmUsage, type LlmUsageEvent, type LlmUsageEventV1, type MessageProcessingStarted, type MessageProcessingUpdate, type NeedsSupportUpdate, type OrchestratorUpdate, Order_By, type OutputEmitted, type OutputEmittedV1, type PipelineProgress, type PipelineProgressV1, type PipelineProgressV2, type PipelineRunStepDetails, type PipelineSourceState, type PlanGenerationStarted, type PlanStepGenerated, type PlanningDecisionCompleted, type PlanningDecisionPlanningRequired, type PlanningDecisionStarted, type PlanningDecisionUpdate, type ProgramExecuteOutcome, type ProgramExecuteUpdate, type ProgramId, type ProgramPackageName, type ProgramRunEvent, type ProgramRunnerAction, type ProgrammerUpdate, type ProjectInfoOutput, PromptQLSdk, type PromptQLSdkOptions, type PromptQlUserId, type PythonRunStepDetails, ROOM_NAME_REGEX, type ResponseGenerationUpdate, type ResponseTruncation, RoomFragment, type RoomVisibilityType, type RunFinished, type RunFinishedOutcome, type RunFinishedV1, type RunProgramRequest, type RunSavedProgramRequest, type RunStarted, type RunStartedV1, type RunStepDetails, type SavedProgramRunnerUpdate, type SavedProgramRunnerUpdateV0, type ScheduledAgentTriggerEventId, type ScheduledAgentTriggerId, type ScheduledAgentTriggerPayload, type ScheduledAgentTriggerPayloadV1, type ScheduledAgentTriggerType, type SchemaContext, type SchemaExplored, type SchemaExplorerCompleted, type SchemaExplorerStarted, type SchemaExplorerUpdate, type SchemaTask, type SchemaTasksGenerationCompleted, type SchemaTasksGenerationStarted, type SchemaTasksGenerationUpdate, type SearchWikiPagesResult, type SendMessageToThreadArguments, type SendMessageToThreadOutput, SendThreadMessageMutationVariables, type ServerMetadata, type ShelfActionEvent, type ShelfUpdate, type ShelfUpdateV1, type SkillType, type SocialFeedRatingLlmUsage, type SocialFeedRatingUpdate, type Span, type Sql, type SqlError, type SqlErrorType, type SqlErrorV1, type SqlExecuteCompleted, type SqlExecuteCompletedV1, type SqlExecuteOutcome, type SqlExecuteOutcome2, type SqlExecuteStarted, type SqlExecuteStartedV1, type SqlQueryId, type SqlRunStepDetails, type StartThreadArguments, StartThreadMutationVariables, type StartThreadOutput, type StartingOrchestrator, type StepExecutionFinished, type StepExecutionFinishedV1, type StepExecutionStarted, type StepExecutionStartedV1, type StepUpdate, type StreamThreadEventOptions, type TargetWikiPage, type TasksGenerated, type Teaching, type TeachingId, type ThreadEvent, type ThreadEvent$1 as ThreadEventData, ThreadFragment, type TransactionId, type TzWrapper, USER_AGENT, type UiBuildFailure, type UiBuildRunStepDetails, type UiMetadata, type UiProgrammerUpdate, type UserCancel, type UserCancelEvent, type UserMessage, type UserMessageEvent, type UserUpload, type VersionedAgentUpdate, type VersionedOrUnversionedAgentUpdate, type Warning, type WikiAuditId, type WikiChange, type WikiContent, type WikiDelta, type WikiExplorerCompleted, type WikiExplorerStarted, type WikiExplorerUpdate, type WikiGenerationUpdate, type WikiInfoGenerated, type WikiLearningSuggestionUpdate, type WikiPageDetail, type WikiPageItem, type WikiPageNamespace, type WikiPagePreview, type WikiPageSearchResult, type WikiPageV1, type WikiSection, type WikiSelectionUpdate, type WikiTitle, buildPromptQLUrl, cancelAgentMessage, createApolloClient, createRoom, diffThreadEvents, downloadArtifactData, getAgentGeneratedResponse, getAgentInteractionDecisionAcceptInteractionEvent, getAgentInteractionDecisionDeclineInteractionEvent, getAgentInteractionFinishedEvent, getAgentMessageProcessingStartedEvent, getAgentOrchestratorContextExplorerCompletedEvent, getAgentOrchestratorContextExplorerStartedEvent, getAgentOrchestratorContextExplorerUpdateEvent, getAgentOrchestratorSchemaExplorerCodeExecutionCompleteEvent, getAgentOrchestratorSchemaExplorerCodeOutputAnalyzedEvent, getAgentOrchestratorSchemaExplorerCompletedEvent, getAgentOrchestratorSchemaExplorerGeneratedCodeEvent, getAgentOrchestratorSchemaExplorerSchemaExploredEvent, getAgentOrchestratorSchemaExplorerStartedEvent, getAgentOrchestratorSchemaExplorerUpdateEvent, getAgentOrchestratorSchemaTasksGeneratedEvent, getAgentOrchestratorSchemaTasksGenerationCompletedEvent, getAgentOrchestratorSchemaTasksGenerationStartedEvent, getAgentOrchestratorSchemaTasksGenerationUpdateEvent, getAgentOrchestratorStepProgrammerEvent, getAgentOrchestratorStepSavedProgramRunnerEvent, getAgentOrchestratorStepUiProgrammerEvent, getAgentOrchestratorStepUpdateEvent, getAgentOrchestratorUpdateEvent, getAgentOrchestratorWikiExplorerCompletedEvent, getAgentOrchestratorWikiExplorerStartedEvent, getAgentOrchestratorWikiExplorerUpdateEvent, getAgentOrchestratorWikiInfoGeneratedEvent, getAgentPlanGenerationStartedEvent, getAgentPlanStepGeneratedEvent, getAgentPlanningDecisionCompletedEvent, getAgentPlanningDecisionPlanningRequiredEvent, getAgentPlanningDecisionStartedEvent, getAgentPlanningDecisionUpdateEvent, getAgentStartingOrchestratorEvent, getArtifactMetadata, getThread, getThreadEventMessageId, getThreadEvents, getUserCancelEvent, getUserMessageEvent, getWikiPage, isInteractionAnalyzing, listArtifactMetadataByThreadId, listRooms, listThreads, listWikiPages, searchWikiPages, sendThreadMessage, startThread, streamThreadMessageEvents, subscribeThreadEvents, validateRoomName };
+export { type AgentGeneratedResponse, type AgentLearningUpdate, type AgentLoopAction, type AgentLoopActionLegacy, type AgentLoopActionResult, type AgentLoopActionUpdate, type AgentLoopActionUpdateUnversioned, type AgentLoopActionUpdateVersioned, type AgentLoopTerminalAction, type AgentLoopUpdate, type AgentTrigger, type AgentUpdate, type AgentUpdateContent, type ApolloClientOptions, type ArtifactDataPreview, type ArtifactError, type ArtifactErrorV1, type ArtifactId, type ArtifactMetadata, type ArtifactReference, type ArtifactReference1, type ArtifactType, type ArtifactUpdate, type ArtifactUpdate1, type AssumptionFactCheck, type BuildError, type BuildErrorV1, type BuiltUi, type BuiltUi1, CancelAgentMessageMutationVariables, type CheckedAssumption, type CheckedTopic, type CodeBlock, type CodeError, type CodeErrorV1, type CodeExecutionComplete, type CodeOutputAnalysis, type CodeOutputAnalyzed, type ComponentResponse, type ComponentResponse1, type ComponentResponse2, type ComponentResponse3, type ComponentResponse4, type ComponentResponse5, type ConfidenceAnalysis, type ConfidenceAnalysisLlmUsage, type ConfidenceAnalysisUpdate, type ContextExplorerCompleted, type ContextExplorerStarted, type ContextExplorerUpdate, type CopyFileEntry, type CreateRoomArguments, type CreateWikiPageArgs, type DataArtifactUpdated, type DataArtifactUpdatedV1, type DecideNextStepsFields, type EventOfKind, type ExecuteProgramRequestData, type ExecuteProgramRequestProvenance, type ExternalKnowledgeExplorerAttempt, type ExternalKnowledgeExplorerAttempt1, type ExternalKnowledgeSummary, type FactSource, type FederatedWikiName, type GeneratedCode, type GeneratedFile, type GeneratedResponse, type GeneratedUiCode, type GetThreadEventOptions, GetThreadsQueryVariables, type IPromptQLSdk, type InteractionDecision, type InteractionDecisionAccept, type InteractionDecisionDecline, type InteractionDecisionUpdate, type InteractionFinishedEvent, type InteractionFinishedUpdate, type InteractionOutcome, type InteractionOutcomeStatus, type InteractionUpdate, type InternalError, type InternalErrorV1, type InternalUpdate, type InterruptedByTrigger, type KeysOfUnion, type LearningBlockId, type LearningSuggestion, type LearningSuggestionUpdate, type LearningSuggestionUpdateV1, type ListWikiPageArgs, type LlmResponse, type LlmUsage, type LlmUsageEvent, type LlmUsageEventV1, type MessageProcessingStarted, type MessageProcessingUpdate, type NeedsSupportUpdate, type OrchestratorUpdate, Order_By, type OutputEmitted, type OutputEmittedV1, type PipelineProgress, type PipelineProgressV1, type PipelineProgressV2, type PipelineRunStepDetails, type PipelineSourceState, type PlanGenerationStarted, type PlanStepGenerated, type PlanningDecisionCompleted, type PlanningDecisionPlanningRequired, type PlanningDecisionStarted, type PlanningDecisionUpdate, type ProgramExecuteOutcome, type ProgramExecuteUpdate, type ProgramExecutionTriggerInterruption, type ProgramId, type ProgramPackageName, type ProgramRunEvent, type ProgramRunSqlExecuteOutcome, type ProgramRunnerAction, type ProgrammerUpdate, type ProjectInfoOutput, PromptQLSdk, type PromptQLSdkOptions, type PromptQlUserId, type PythonRunStepDetails, ROOM_NAME_REGEX, type ResponseGenerationUpdate, type ResponseTruncation, RoomFragment, type RoomVisibilityType, type RunFinished, type RunFinishedOutcome, type RunFinishedV1, type RunProgramRequest, type RunSavedProgramRequest, type RunStarted, type RunStartedV1, type RunStepDetails, type RuntimeArtifactType, type SavedProgramRunnerUpdate, type SavedProgramRunnerUpdateV0, type ScheduledAgentTriggerEventId, type ScheduledAgentTriggerId, type ScheduledAgentTriggerPayload, type ScheduledAgentTriggerPayloadV1, type ScheduledAgentTriggerType, type SchemaContext, type SchemaExplored, type SchemaExplorerCompleted, type SchemaExplorerStarted, type SchemaExplorerUpdate, type SchemaTask, type SchemaTasksGenerationCompleted, type SchemaTasksGenerationStarted, type SchemaTasksGenerationUpdate, type SearchWikiPagesResult, type SendMessageToThreadArguments, type SendMessageToThreadOutput, SendThreadMessageMutationVariables, type ServerMetadata, type ShelfActionEvent, type ShelfSchemaName, type ShelfTransactionOpened, type ShelfTransactionOpenedV1, type ShelfTransactionSuspended, type ShelfTransactionSuspendedV1, type ShelfUpdate, type ShelfUpdateV1, type SkillType, type SocialFeedRatingLlmUsage, type SocialFeedRatingUpdate, type Span, type Sql, type SqlError, type SqlErrorType, type SqlErrorV1, type SqlExecuteCompleted, type SqlExecuteCompletedV1, type SqlExecuteOutcome, type SqlExecuteStarted, type SqlExecuteStartedV1, type SqlQueryId, type SqlRunStepDetails, type StartThreadArguments, StartThreadMutationVariables, type StartThreadOutput, type StartingOrchestrator, type StepExecutionFinished, type StepExecutionFinishedV1, type StepExecutionStarted, type StepExecutionStartedV1, type StepUpdate, type StreamThreadEventOptions, type TargetWikiPage, type TasksGenerated, type Teaching, type TeachingId, type ThreadEvent, type ThreadEvent$1 as ThreadEventData, ThreadFragment, type ThreadId, type TransactionId, type TzWrapper, USER_AGENT, type UiBuildFailure, type UiBuildRunStepDetails, type UiMetadata, type UiProgrammerUpdate, type UpdateWikiContentArgs, type UserCancel, type UserCancelEvent, type UserEventProvenance, type UserMessage, type UserMessageEvent, type UserUpload, type VersionedAgentUpdate, type VersionedOrUnversionedAgentUpdate, type Warning, type WikiAuditId, type WikiChange, type WikiContent, type WikiDelta, type WikiExplorerCompleted, type WikiExplorerStarted, type WikiExplorerUpdate, type WikiGenerationUpdate, type WikiInfoGenerated, type WikiLearningSuggestionUpdate, type WikiPageDetail, type WikiPageItem, type WikiPageNamespace, type WikiPagePreview, type WikiPageSearchResult, type WikiPageV1, type WikiSection, type WikiSelectionUpdate, type WikiTitle, buildPromptQLUrl, cancelAgentMessage, createApolloClient, createRoom, createWikiPage, deleteWikiPage, diffThreadEvents, downloadArtifactData, getAgentGeneratedResponse, getAgentInteractionDecisionAcceptInteractionEvent, getAgentInteractionDecisionDeclineInteractionEvent, getAgentInteractionFinishedEvent, getAgentMessageProcessingStartedEvent, getAgentOrchestratorContextExplorerCompletedEvent, getAgentOrchestratorContextExplorerStartedEvent, getAgentOrchestratorContextExplorerUpdateEvent, getAgentOrchestratorSchemaExplorerCodeExecutionCompleteEvent, getAgentOrchestratorSchemaExplorerCodeOutputAnalyzedEvent, getAgentOrchestratorSchemaExplorerCompletedEvent, getAgentOrchestratorSchemaExplorerGeneratedCodeEvent, getAgentOrchestratorSchemaExplorerSchemaExploredEvent, getAgentOrchestratorSchemaExplorerStartedEvent, getAgentOrchestratorSchemaExplorerUpdateEvent, getAgentOrchestratorSchemaTasksGeneratedEvent, getAgentOrchestratorSchemaTasksGenerationCompletedEvent, getAgentOrchestratorSchemaTasksGenerationStartedEvent, getAgentOrchestratorSchemaTasksGenerationUpdateEvent, getAgentOrchestratorStepProgrammerEvent, getAgentOrchestratorStepSavedProgramRunnerEvent, getAgentOrchestratorStepUiProgrammerEvent, getAgentOrchestratorStepUpdateEvent, getAgentOrchestratorUpdateEvent, getAgentOrchestratorWikiExplorerCompletedEvent, getAgentOrchestratorWikiExplorerStartedEvent, getAgentOrchestratorWikiExplorerUpdateEvent, getAgentOrchestratorWikiInfoGeneratedEvent, getAgentPlanGenerationStartedEvent, getAgentPlanStepGeneratedEvent, getAgentPlanningDecisionCompletedEvent, getAgentPlanningDecisionPlanningRequiredEvent, getAgentPlanningDecisionStartedEvent, getAgentPlanningDecisionUpdateEvent, getAgentStartingOrchestratorEvent, getArtifactMetadata, getThread, getThreadEventMessageId, getThreadEvents, getUserCancelEvent, getUserMessageEvent, getWikiPage, isInteractionAnalyzing, listArtifactMetadataByThreadId, listRooms, listThreads, listWikiPages, searchWikiPages, sendThreadMessage, startThread, streamThreadMessageEvents, subscribeThreadEvents, updateWikiPage, validateRoomName };