@athenaintel/react 0.57.1 → 0.59.0

package/dist/agent-runtime/src/typed-interrupt-kinds.d.ts

@@ -0,0 +1,173 @@
+/**
+ * What a typed card needs beyond the selector (`typed-interrupts.ts`): which
+ * answers decide something only a person may decide (`isTypedApprovalInterrupt`),
+ * the stamps the raiser's stale-resume check reads, the timer, and each kind's
+ * context reader and resume, each mirroring its raiser
+ * (`agora/services/interrupts/definitions.py`) and Olympus's
+ * `config/interruptDefinitions.ts`.
+ */
+import { type TypedInterruptPayload } from './typed-interrupts';
+export declare function isTypedApprovalInterrupt(payload: TypedInterruptPayload): boolean;
+/** Whether a typed answer lets anything run, as its raiser reads it (fails closed). */
+export declare function typedAnswerLetsSomethingRun(value: unknown): boolean;
+/** The keys the raiser's stale-resume check reads on an answer. */
+export declare const TYPED_INTERRUPT_ID_KEY = "__interrupt_id__";
+export declare const TYPED_INTERRUPT_INSTANCE_KEY = "__interrupt_instance_id__";
+/**
+ * The answer as it leaves: the kind's resume value stamped with the park it
+ * answers (`__interrupt_id__`, `__interrupt_instance_id__`) and serialized as
+ * plain JSON, so an optional field a card left unset never reaches statewire
+ * as `undefined` (an invalid document there).
+ */
+export declare function stampTypedInterruptAnswer({ payload, value, }: {
+    payload: TypedInterruptPayload;
+    value: Readonly<Record<string, unknown>>;
+}): Record<string, unknown>;
+/** `{ action: 'cancel' }`: every typed raiser ends the interrupted operation (`FormCancelledError`). */
+export declare function typedInterruptCancel(): Record<string, string>;
+/** Whether the backend's timer answers this park for the person at a deadline. */
+export declare function hasInterruptTimeout(payload: TypedInterruptPayload): boolean;
+/** Seconds until the backend's timer answers (never negative), or `null` without one. */
+export declare function interruptTimeoutRemaining(payload: TypedInterruptPayload, now?: number): number | null;
+/**
+ * The park's message without the raiser's `(timeout in 180s)` suffix, for
+ * once the person stopped the timer and the card says "take your time".
+ */
+export declare function stripInterruptTimeoutText(message: string | null | undefined): string;
+/**
+ * The key a timed interrupt's draft is saved under: the one the backend's
+ * timer worker checks before it fires (`_draft_interrupt_id_for_timeout`: the
+ * park's `timeout_at`, else its source). A draft under any other key does not
+ * hold the timer.
+ */
+export declare function interruptDraftId(payload: TypedInterruptPayload): string;
+/** The kinds of question the `ask` tool asks. */
+export declare const QuestionType: {
+    readonly TEXT: 'text';
+    readonly YES_NO: 'yes_no';
+    readonly SINGLE_CHOICE: 'single_choice';
+    readonly MULTI_CHOICE: 'multi_choice';
+};
+export type QuestionType = (typeof QuestionType)[keyof typeof QuestionType];
+export interface TypedQuestion {
+    readonly text: string;
+    readonly type: QuestionType;
+    readonly options: readonly string[];
+    /** The answer the agent recommends (an option, or `yes` / `no`); also the timeout's answer. */
+    readonly recommended: string | null;
+}
+export interface QuestionnaireContext {
+    /** The questionnaire's own title, when the agent gave one. */
+    readonly title: string | null;
+    readonly questions: readonly TypedQuestion[];
+}
+export declare function isQuestionnaireInterrupt(payload: TypedInterruptPayload): boolean;
+/** The questions the `ask` tool parked on (`misc_tools.py`), in order. */
+export declare function readQuestionnaireContext(payload: TypedInterruptPayload): QuestionnaireContext;
+/** One answer of a questionnaire's resume (`QuestionnaireAnswer`). */
+export interface QuestionnaireAnswer {
+    readonly value: string;
+    readonly comment: string | null;
+}
+/** The questionnaire's resume (`QuestionnaireResume`); an empty list is the card's cancel. */
+export declare function questionnaireResume(answers: readonly QuestionnaireAnswer[]): Record<string, unknown>;
+/** One toolkit `toggle_toolkit` proposes (`agent_config_tools.py`). */
+export interface ToolkitSelectionItem {
+    readonly toolkit_id: string;
+    readonly display_name: string;
+    readonly description: string | null;
+    /** The agent's reason it needs this toolkit, shown to the person. */
+    readonly rationale: string | null;
+    /** Tools this toolkit adds beyond those already on (the tool cap's headroom). */
+    readonly added_tool_count?: number;
+}
+export interface ToolkitSelectionContext {
+    readonly action: 'enable' | 'disable';
+    readonly toolkits: readonly ToolkitSelectionItem[];
+    /** Tools already on and the run's cap (enable only), so the card warns before a breach. */
+    readonly current_tool_count?: number;
+    readonly max_tools?: number;
+}
+export declare function isToolkitSelectionInterrupt(payload: TypedInterruptPayload): boolean;
+/**
+ * The toolkits `toggle_toolkit` asks to turn on or off. Read whole or not at
+ * all, as Olympus's schema reads it: a malformed context is an empty enable.
+ */
+export declare function readToolkitSelectionContext(payload: TypedInterruptPayload): ToolkitSelectionContext;
+/** The toolkit selection's resume (`ToolkitSelectionResume`). */
+export declare function toolkitSelectionResume({ action, approvedToolkitIds, reason, }: {
+    action: 'approve' | 'reject';
+    approvedToolkitIds: readonly string[];
+    reason?: string;
+}): Record<string, unknown>;
+/** One saved login the browse-profile gate asks to use (`browse_profile_gate_node.py`). */
+export interface BrowseProfileApprovalProfile {
+    readonly profile_asset_id: string;
+    /** What the ordinary approve grants: `session` (this browser session) or `attempt` (this one action). */
+    readonly approval_scope: string | null;
+}
+export interface BrowseProfileApprovalContext {
+    readonly profiles: readonly BrowseProfileApprovalProfile[];
+    /** Stamped when every shown profile may be approved for the rest of the thread. */
+    readonly sessionApprovalAllowed: boolean;
+}
+export declare function isBrowseProfileApprovalInterrupt(payload: TypedInterruptPayload): boolean;
+export declare function readBrowseProfileApprovalContext(payload: TypedInterruptPayload): BrowseProfileApprovalContext;
+/** The browse-profile gate's resume (`BrowseProfileApprovalResume`). */
+export declare function browseProfileApprovalResume({ action, forSession, }: {
+    action: 'approve' | 'reject';
+    /** On an approve: stop asking about these profiles for the rest of the thread. */
+    forSession?: boolean;
+}): Record<string, unknown>;
+export declare function isPmScheduleApprovalInterrupt(payload: TypedInterruptPayload): boolean;
+/** The project manager schedule a person approves (`pm_tools.py`). */
+export interface PmScheduleApprovalContext {
+    /** `delete` for a deletion; anything else is a creation. */
+    readonly action: string | null;
+    /** The schedule's facts, in the card's order, by their context key. */
+    readonly fields: readonly (readonly [key: string, value: string])[];
+}
+export declare function readPmScheduleApprovalContext(payload: TypedInterruptPayload): PmScheduleApprovalContext;
+/** An approval's resume (`HITLResume`, `PMScheduleApprovalResume`): approve, or reject with a reason. */
+export declare function typedApprovalResume({ action, reason, }: {
+    action: 'approve' | 'reject';
+    reason?: string;
+}): Record<string, unknown>;
+export declare function isWaitForMinutesInterrupt(payload: TypedInterruptPayload): boolean;
+/** The wait `wait_for_minutes` announced (`misc_tools.py`). */
+export interface WaitForMinutesContext {
+    readonly minutes: number;
+    readonly reason: string | null;
+    /** The whole wait in seconds, when the raiser stamped it on the context. */
+    readonly timeoutSeconds: number | null;
+}
+/**
+ * Each field on its own: the raiser sends `reason: null` for a wait without
+ * one, which must not lose the minutes.
+ */
+export declare function readWaitForMinutesContext(payload: TypedInterruptPayload): WaitForMinutesContext;
+export declare function isRequestFileInterrupt(payload: TypedInterruptPayload): boolean;
+/** What `request_file_from_user` asks for (`misc_tools.py`). */
+export interface RequestFileContext {
+    readonly prompt: string;
+    readonly allowMultiple: boolean;
+}
+export declare function readRequestFileContext(payload: TypedInterruptPayload): RequestFileContext;
+/** One uploaded file of `request_file_from_user`'s resume (`RequestedFile`). */
+export interface RequestedFile {
+    readonly asset_id: string;
+    readonly filename: string;
+    /** The `[@title](link)` mention the agent can quote. */
+    readonly mention: string | null;
+}
+/** The file request's resume (`RequestFileResume`). */
+export declare function requestFileResume(files: readonly RequestedFile[]): Record<string, unknown>;
+/** The gated call of a tool-raised HITL approval (`raise_hitl_interrupt`). */
+export interface TypedHitlContext {
+    readonly toolId: string | null;
+    readonly toolCallId: string | null;
+    readonly toolArgs: Readonly<Record<string, unknown>>;
+    /** What the backend resolved about the call before asking (`approval_context`). */
+    readonly approvalContext: unknown;
+}
+export declare function readTypedHitlContext(payload: TypedInterruptPayload): TypedHitlContext;

package/dist/agent-runtime/src/typed-interrupt-kinds.js

@@ -0,0 +1,247 @@
+import { TypedInterruptSource, TypedInterruptType } from "./typed-interrupts.js";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isOptional(value, check) {
+  return value === void 0 || check(value);
+}
+const isString = (value) => typeof value === "string";
+const isFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value);
+const TYPED_APPROVAL_SOURCES = /* @__PURE__ */ new Set([
+  TypedInterruptSource.PM_SCHEDULE_APPROVAL,
+  TypedInterruptSource.BROWSE_PROFILE_APPROVAL,
+  TypedInterruptSource.TOOLKIT_SELECTION
+]);
+function isTypedApprovalInterrupt(payload) {
+  return payload.type === TypedInterruptType.HITL || TYPED_APPROVAL_SOURCES.has(payload.source);
+}
+const TYPED_NON_RUNNING_ACTIONS = /* @__PURE__ */ new Set(["reject", "cancel"]);
+function typedAnswerLetsSomethingRun(value) {
+  if (!isRecord(value)) return true;
+  return !(typeof value.action === "string" && TYPED_NON_RUNNING_ACTIONS.has(value.action));
+}
+const TYPED_INTERRUPT_ID_KEY = "__interrupt_id__";
+const TYPED_INTERRUPT_INSTANCE_KEY = "__interrupt_instance_id__";
+function stampTypedInterruptAnswer({
+  payload,
+  value
+}) {
+  const stamped = {
+    ...value,
+    [TYPED_INTERRUPT_ID_KEY]: payload.source,
+    [TYPED_INTERRUPT_INSTANCE_KEY]: payload.interrupt_instance_id
+  };
+  const parsed = JSON.parse(JSON.stringify(stamped));
+  return isRecord(parsed) ? parsed : {};
+}
+function typedInterruptCancel() {
+  return { action: "cancel" };
+}
+function hasInterruptTimeout(payload) {
+  return payload.timeout_seconds !== void 0 && payload.timeout_at !== void 0;
+}
+function interruptTimeoutRemaining(payload, now = Date.now()) {
+  if (!payload.timeout_at) return null;
+  const deadline = new Date(payload.timeout_at).getTime();
+  if (Number.isNaN(deadline)) return null;
+  return Math.max(0, (deadline - now) / 1e3);
+}
+function stripInterruptTimeoutText(message) {
+  if (!message) return "";
+  return message.replace(/\s*\(timeout in \d+s\)/, "");
+}
+function interruptDraftId(payload) {
+  return payload.timeout_at ?? payload.source;
+}
+function isCustomWithSource(payload, source) {
+  return payload.type === TypedInterruptType.CUSTOM && payload.source === source;
+}
+const isStringArray = (value) => Array.isArray(value) && value.every(isString);
+function optionalText(value) {
+  return isString(value) ? value : null;
+}
+const QuestionType = {
+  TEXT: "text",
+  YES_NO: "yes_no",
+  SINGLE_CHOICE: "single_choice",
+  MULTI_CHOICE: "multi_choice"
+};
+const QUESTION_TYPES = new Set(Object.values(QuestionType));
+function isQuestionnaireInterrupt(payload) {
+  return isCustomWithSource(payload, TypedInterruptSource.ASK_QUESTIONNAIRE);
+}
+function readQuestionnaireContext(payload) {
+  const { context } = payload;
+  const questions = Array.isArray(context.questions) ? context.questions.filter(isRecord).map(
+    (question) => ({
+      text: isString(question.text) ? question.text : "",
+      type: isString(question.type) && QUESTION_TYPES.has(question.type) ? question.type : QuestionType.TEXT,
+      options: isStringArray(question.options) ? question.options : [],
+      recommended: optionalText(question.recommended)
+    })
+  ) : [];
+  return { title: optionalText(context.title), questions };
+}
+function questionnaireResume(answers) {
+  return { answers: answers.map(({ value, comment }) => ({ value, comment })) };
+}
+function isToolkitSelectionInterrupt(payload) {
+  return isCustomWithSource(payload, TypedInterruptSource.TOOLKIT_SELECTION);
+}
+const NO_TOOLKIT_SELECTION = { action: "enable", toolkits: [] };
+function readToolkitItem(value) {
+  if (!isRecord(value) || !isString(value.toolkit_id) || !isString(value.display_name)) return null;
+  const { description, rationale, added_tool_count: added } = value;
+  if (description != null && !isString(description) || rationale != null && !isString(rationale) || !isOptional(added, isFiniteNumber)) {
+    return null;
+  }
+  return {
+    toolkit_id: value.toolkit_id,
+    display_name: value.display_name,
+    description: optionalText(description),
+    rationale: optionalText(rationale),
+    ...isFiniteNumber(added) ? { added_tool_count: added } : {}
+  };
+}
+function readToolkitSelectionContext(payload) {
+  const { context } = payload;
+  const { action, toolkits, total, current_tool_count: current, max_tools: max } = context;
+  if (action !== "enable" && action !== "disable") return NO_TOOLKIT_SELECTION;
+  if (!Array.isArray(toolkits)) return NO_TOOLKIT_SELECTION;
+  if (!isOptional(total, isFiniteNumber) || !isOptional(current, isFiniteNumber) || !isOptional(max, isFiniteNumber)) {
+    return NO_TOOLKIT_SELECTION;
+  }
+  const items = toolkits.map(readToolkitItem);
+  if (items.some((item) => item === null)) return NO_TOOLKIT_SELECTION;
+  return {
+    action,
+    toolkits: items,
+    ...isFiniteNumber(current) ? { current_tool_count: current } : {},
+    ...isFiniteNumber(max) ? { max_tools: max } : {}
+  };
+}
+function toolkitSelectionResume({
+  action,
+  approvedToolkitIds,
+  reason
+}) {
+  return {
+    action,
+    approved_toolkit_ids: action === "approve" ? [...approvedToolkitIds] : [],
+    ...reason ? { reason } : {}
+  };
+}
+function isBrowseProfileApprovalInterrupt(payload) {
+  return isCustomWithSource(payload, TypedInterruptSource.BROWSE_PROFILE_APPROVAL);
+}
+function readBrowseProfileApprovalContext(payload) {
+  const approval = payload.context.browse_profile_approval;
+  if (!isRecord(approval)) return { profiles: [], sessionApprovalAllowed: false };
+  const profiles = Array.isArray(approval.profiles) ? approval.profiles.flatMap(
+    (profile) => isRecord(profile) && isString(profile.profile_asset_id) ? [
+      {
+        profile_asset_id: profile.profile_asset_id,
+        approval_scope: optionalText(profile.approval_scope)
+      }
+    ] : []
+  ) : [];
+  return { profiles, sessionApprovalAllowed: approval.session_approval_allowed === true };
+}
+function browseProfileApprovalResume({
+  action,
+  forSession = false
+}) {
+  return action === "approve" && forSession ? { action, scope: "session" } : { action };
+}
+function isPmScheduleApprovalInterrupt(payload) {
+  return isCustomWithSource(payload, TypedInterruptSource.PM_SCHEDULE_APPROVAL);
+}
+const PM_SCHEDULE_FIELDS = [
+  "project_asset_id",
+  "cron",
+  "timezone",
+  "summary",
+  "scheduled_for",
+  "schedule_id"
+];
+function readPmScheduleApprovalContext(payload) {
+  const { context } = payload;
+  const fields = PM_SCHEDULE_FIELDS.flatMap((key) => {
+    const value = context[key];
+    return value ? [[key, String(value)]] : [];
+  });
+  return { action: optionalText(context.action), fields };
+}
+function typedApprovalResume({
+  action,
+  reason
+}) {
+  return reason ? { action, reason } : { action };
+}
+function isWaitForMinutesInterrupt(payload) {
+  return isCustomWithSource(payload, TypedInterruptSource.WAIT_FOR_MINUTES);
+}
+function readWaitForMinutesContext(payload) {
+  const { minutes, reason, timeout_seconds: timeoutSeconds } = payload.context;
+  return {
+    minutes: isFiniteNumber(minutes) ? minutes : 0,
+    reason: isString(reason) && reason ? reason : null,
+    timeoutSeconds: isFiniteNumber(timeoutSeconds) ? timeoutSeconds : null
+  };
+}
+function isRequestFileInterrupt(payload) {
+  return isCustomWithSource(payload, TypedInterruptSource.REQUEST_FILE);
+}
+function readRequestFileContext(payload) {
+  const { prompt, allow_multiple: allowMultiple } = payload.context;
+  return {
+    prompt: isString(prompt) && prompt || payload.message || "Upload a file to continue.",
+    allowMultiple: allowMultiple === true
+  };
+}
+function requestFileResume(files) {
+  return {
+    files: files.map(({ asset_id, filename, mention }) => ({ asset_id, filename, mention }))
+  };
+}
+function readTypedHitlContext(payload) {
+  const { context } = payload;
+  return {
+    toolId: optionalText(context.tool_id),
+    toolCallId: optionalText(context.tool_call_id),
+    toolArgs: isRecord(context.tool_args) ? context.tool_args : {},
+    approvalContext: context.approval_context
+  };
+}
+export {
+  QuestionType,
+  TYPED_INTERRUPT_ID_KEY,
+  TYPED_INTERRUPT_INSTANCE_KEY,
+  browseProfileApprovalResume,
+  hasInterruptTimeout,
+  interruptDraftId,
+  interruptTimeoutRemaining,
+  isBrowseProfileApprovalInterrupt,
+  isPmScheduleApprovalInterrupt,
+  isQuestionnaireInterrupt,
+  isRequestFileInterrupt,
+  isToolkitSelectionInterrupt,
+  isTypedApprovalInterrupt,
+  isWaitForMinutesInterrupt,
+  questionnaireResume,
+  readBrowseProfileApprovalContext,
+  readPmScheduleApprovalContext,
+  readQuestionnaireContext,
+  readRequestFileContext,
+  readToolkitSelectionContext,
+  readTypedHitlContext,
+  readWaitForMinutesContext,
+  requestFileResume,
+  stampTypedInterruptAnswer,
+  stripInterruptTimeoutText,
+  toolkitSelectionResume,
+  typedAnswerLetsSomethingRun,
+  typedApprovalResume,
+  typedInterruptCancel
+};
+//# sourceMappingURL=typed-interrupt-kinds.js.map

package/dist/agent-runtime/src/typed-interrupt-kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-interrupt-kinds.js","sources":["../../../../agent-runtime/src/typed-interrupt-kinds.ts"],"sourcesContent":["/**\n * What a typed card needs beyond the selector (`typed-interrupts.ts`): which\n * answers decide something only a person may decide (`isTypedApprovalInterrupt`),\n * the stamps the raiser's stale-resume check reads, the timer, and each kind's\n * context reader and resume, each mirroring its raiser\n * (`agora/services/interrupts/definitions.py`) and Olympus's\n * `config/interruptDefinitions.ts`.\n */\n\nimport {\n  type TypedInterruptPayload,\n  TypedInterruptSource,\n  TypedInterruptType,\n} from './typed-interrupts';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isOptional<T>(value: unknown, check: (candidate: unknown) => candidate is T): boolean {\n  return value === undefined || check(value);\n}\n\nconst isString = (value: unknown): value is string => typeof value === 'string';\nconst isFiniteNumber = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isFinite(value);\n\n/**\n * The parks a person answers by approving: a tool-raised HITL approval (type\n * `hitl`), a project manager's schedule (standing work), a saved login the\n * agent asks to use, and toolkits it asks to turn on. A question the agent\n * asked (a form, a questionnaire, a file) is not: answering it decides\n * nothing. Mirrors agora's `answer_checks.is_typed_approval_interrupt`, which\n * holds an approving answer to a signed-in person (or, while checks are\n * enforced, a device key with a passkey check).\n */\nconst TYPED_APPROVAL_SOURCES: ReadonlySet<string> = new Set([\n  TypedInterruptSource.PM_SCHEDULE_APPROVAL,\n  TypedInterruptSource.BROWSE_PROFILE_APPROVAL,\n  TypedInterruptSource.TOOLKIT_SELECTION,\n]);\n\nexport function isTypedApprovalInterrupt(payload: TypedInterruptPayload): boolean {\n  return payload.type === TypedInterruptType.HITL || TYPED_APPROVAL_SOURCES.has(payload.source);\n}\n\n/**\n * What every typed raiser reads as running nothing: a reject, and the card's\n * cancel, which ends the interrupted operation (agora's\n * `TYPED_NON_RUNNING_ACTIONS`). Anything else, unreadable included, runs.\n */\nconst TYPED_NON_RUNNING_ACTIONS: ReadonlySet<string> = new Set(['reject', 'cancel']);\n\n/** Whether a typed answer lets anything run, as its raiser reads it (fails closed). */\nexport function typedAnswerLetsSomethingRun(value: unknown): boolean {\n  if (!isRecord(value)) return true;\n  return !(typeof value.action === 'string' && TYPED_NON_RUNNING_ACTIONS.has(value.action));\n}\n\n/** The keys the raiser's stale-resume check reads on an answer. */\nexport const TYPED_INTERRUPT_ID_KEY = '__interrupt_id__';\nexport const TYPED_INTERRUPT_INSTANCE_KEY = '__interrupt_instance_id__';\n\n/**\n * The answer as it leaves: the kind's resume value stamped with the park it\n * answers (`__interrupt_id__`, `__interrupt_instance_id__`) and serialized as\n * plain JSON, so an optional field a card left unset never reaches statewire\n * as `undefined` (an invalid document there).\n */\nexport function stampTypedInterruptAnswer({\n  payload,\n  value,\n}: {\n  payload: TypedInterruptPayload;\n  value: Readonly<Record<string, unknown>>;\n}): Record<string, unknown> {\n  const stamped = {\n    ...value,\n    [TYPED_INTERRUPT_ID_KEY]: payload.source,\n    [TYPED_INTERRUPT_INSTANCE_KEY]: payload.interrupt_instance_id,\n  };\n  const parsed: unknown = JSON.parse(JSON.stringify(stamped));\n  return isRecord(parsed) ? parsed : {};\n}\n\n/** `{ action: 'cancel' }`: every typed raiser ends the interrupted operation (`FormCancelledError`). */\nexport function typedInterruptCancel(): Record<string, string> {\n  return { action: 'cancel' };\n}\n\n// ── Timeouts ─────────────────────────────────────────────────────────────\n\n/** Whether the backend's timer answers this park for the person at a deadline. */\nexport function hasInterruptTimeout(payload: TypedInterruptPayload): boolean {\n  return payload.timeout_seconds !== undefined && payload.timeout_at !== undefined;\n}\n\n/** Seconds until the backend's timer answers (never negative), or `null` without one. */\nexport function interruptTimeoutRemaining(\n  payload: TypedInterruptPayload,\n  now: number = Date.now(),\n): number | null {\n  if (!payload.timeout_at) return null;\n  const deadline = new Date(payload.timeout_at).getTime();\n  if (Number.isNaN(deadline)) return null;\n  return Math.max(0, (deadline - now) / 1000);\n}\n\n/**\n * The park's message without the raiser's `(timeout in 180s)` suffix, for\n * once the person stopped the timer and the card says \"take your time\".\n */\nexport function stripInterruptTimeoutText(message: string | null | undefined): string {\n  if (!message) return '';\n  return message.replace(/\\s*\\(timeout in \\d+s\\)/, '');\n}\n\n/**\n * The key a timed interrupt's draft is saved under: the one the backend's\n * timer worker checks before it fires (`_draft_interrupt_id_for_timeout`: the\n * park's `timeout_at`, else its source). A draft under any other key does not\n * hold the timer.\n */\nexport function interruptDraftId(payload: TypedInterruptPayload): string {\n  return payload.timeout_at ?? payload.source;\n}\n\n// ── Kinds ────────────────────────────────────────────────────────────────\n\nfunction isCustomWithSource(payload: TypedInterruptPayload, source: string): boolean {\n  return payload.type === TypedInterruptType.CUSTOM && payload.source === source;\n}\n\nconst isStringArray = (value: unknown): value is string[] =>\n  Array.isArray(value) && value.every(isString);\n\nfunction optionalText(value: unknown): string | null {\n  return isString(value) ? value : null;\n}\n\n/** The kinds of question the `ask` tool asks. */\nexport const QuestionType = {\n  TEXT: 'text',\n  YES_NO: 'yes_no',\n  SINGLE_CHOICE: 'single_choice',\n  MULTI_CHOICE: 'multi_choice',\n} as const;\n\nexport type QuestionType = (typeof QuestionType)[keyof typeof QuestionType];\n\nconst QUESTION_TYPES: ReadonlySet<string> = new Set(Object.values(QuestionType));\n\nexport interface TypedQuestion {\n  readonly text: string;\n  readonly type: QuestionType;\n  readonly options: readonly string[];\n  /** The answer the agent recommends (an option, or `yes` / `no`); also the timeout's answer. */\n  readonly recommended: string | null;\n}\n\nexport interface QuestionnaireContext {\n  /** The questionnaire's own title, when the agent gave one. */\n  readonly title: string | null;\n  readonly questions: readonly TypedQuestion[];\n}\n\nexport function isQuestionnaireInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.ASK_QUESTIONNAIRE);\n}\n\n/** The questions the `ask` tool parked on (`misc_tools.py`), in order. */\nexport function readQuestionnaireContext(payload: TypedInterruptPayload): QuestionnaireContext {\n  const { context } = payload;\n  const questions = Array.isArray(context.questions)\n    ? context.questions.filter(isRecord).map(\n        (question): TypedQuestion => ({\n          text: isString(question.text) ? question.text : '',\n          type:\n            isString(question.type) && QUESTION_TYPES.has(question.type)\n              ? (question.type as QuestionType)\n              : QuestionType.TEXT,\n          options: isStringArray(question.options) ? question.options : [],\n          recommended: optionalText(question.recommended),\n        }),\n      )\n    : [];\n  return { title: optionalText(context.title), questions };\n}\n\n/** One answer of a questionnaire's resume (`QuestionnaireAnswer`). */\nexport interface QuestionnaireAnswer {\n  readonly value: string;\n  readonly comment: string | null;\n}\n\n/** The questionnaire's resume (`QuestionnaireResume`); an empty list is the card's cancel. */\nexport function questionnaireResume(answers: readonly QuestionnaireAnswer[]): Record<string, unknown> {\n  return { answers: answers.map(({ value, comment }) => ({ value, comment })) };\n}\n\n/** One toolkit `toggle_toolkit` proposes (`agent_config_tools.py`). */\nexport interface ToolkitSelectionItem {\n  readonly toolkit_id: string;\n  readonly display_name: string;\n  readonly description: string | null;\n  /** The agent's reason it needs this toolkit, shown to the person. */\n  readonly rationale: string | null;\n  /** Tools this toolkit adds beyond those already on (the tool cap's headroom). */\n  readonly added_tool_count?: number;\n}\n\nexport interface ToolkitSelectionContext {\n  readonly action: 'enable' | 'disable';\n  readonly toolkits: readonly ToolkitSelectionItem[];\n  /** Tools already on and the run's cap (enable only), so the card warns before a breach. */\n  readonly current_tool_count?: number;\n  readonly max_tools?: number;\n}\n\nexport function isToolkitSelectionInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.TOOLKIT_SELECTION);\n}\n\nconst NO_TOOLKIT_SELECTION: ToolkitSelectionContext = { action: 'enable', toolkits: [] };\n\nfunction readToolkitItem(value: unknown): ToolkitSelectionItem | null {\n  if (!isRecord(value) || !isString(value.toolkit_id) || !isString(value.display_name)) return null;\n  const { description, rationale, added_tool_count: added } = value;\n  if (\n    (description != null && !isString(description)) ||\n    (rationale != null && !isString(rationale)) ||\n    !isOptional(added, isFiniteNumber)\n  ) {\n    return null;\n  }\n  return {\n    toolkit_id: value.toolkit_id,\n    display_name: value.display_name,\n    description: optionalText(description),\n    rationale: optionalText(rationale),\n    ...(isFiniteNumber(added) ? { added_tool_count: added } : {}),\n  };\n}\n\n/**\n * The toolkits `toggle_toolkit` asks to turn on or off. Read whole or not at\n * all, as Olympus's schema reads it: a malformed context is an empty enable.\n */\nexport function readToolkitSelectionContext(payload: TypedInterruptPayload): ToolkitSelectionContext {\n  const { context } = payload;\n  const { action, toolkits, total, current_tool_count: current, max_tools: max } = context;\n  if (action !== 'enable' && action !== 'disable') return NO_TOOLKIT_SELECTION;\n  if (!Array.isArray(toolkits)) return NO_TOOLKIT_SELECTION;\n  if (\n    !isOptional(total, isFiniteNumber) ||\n    !isOptional(current, isFiniteNumber) ||\n    !isOptional(max, isFiniteNumber)\n  ) {\n    return NO_TOOLKIT_SELECTION;\n  }\n  const items = toolkits.map(readToolkitItem);\n  if (items.some((item) => item === null)) return NO_TOOLKIT_SELECTION;\n  return {\n    action,\n    toolkits: items as ToolkitSelectionItem[],\n    ...(isFiniteNumber(current) ? { current_tool_count: current } : {}),\n    ...(isFiniteNumber(max) ? { max_tools: max } : {}),\n  };\n}\n\n/** The toolkit selection's resume (`ToolkitSelectionResume`). */\nexport function toolkitSelectionResume({\n  action,\n  approvedToolkitIds,\n  reason,\n}: {\n  action: 'approve' | 'reject';\n  approvedToolkitIds: readonly string[];\n  reason?: string;\n}): Record<string, unknown> {\n  return {\n    action,\n    approved_toolkit_ids: action === 'approve' ? [...approvedToolkitIds] : [],\n    ...(reason ? { reason } : {}),\n  };\n}\n\n/** One saved login the browse-profile gate asks to use (`browse_profile_gate_node.py`). */\nexport interface BrowseProfileApprovalProfile {\n  readonly profile_asset_id: string;\n  /** What the ordinary approve grants: `session` (this browser session) or `attempt` (this one action). */\n  readonly approval_scope: string | null;\n}\n\nexport interface BrowseProfileApprovalContext {\n  readonly profiles: readonly BrowseProfileApprovalProfile[];\n  /** Stamped when every shown profile may be approved for the rest of the thread. */\n  readonly sessionApprovalAllowed: boolean;\n}\n\nexport function isBrowseProfileApprovalInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.BROWSE_PROFILE_APPROVAL);\n}\n\nexport function readBrowseProfileApprovalContext(\n  payload: TypedInterruptPayload,\n): BrowseProfileApprovalContext {\n  const approval = payload.context.browse_profile_approval;\n  if (!isRecord(approval)) return { profiles: [], sessionApprovalAllowed: false };\n  const profiles = Array.isArray(approval.profiles)\n    ? approval.profiles.flatMap((profile): BrowseProfileApprovalProfile[] =>\n        isRecord(profile) && isString(profile.profile_asset_id)\n          ? [\n              {\n                profile_asset_id: profile.profile_asset_id,\n                approval_scope: optionalText(profile.approval_scope),\n              },\n            ]\n          : [],\n      )\n    : [];\n  return { profiles, sessionApprovalAllowed: approval.session_approval_allowed === true };\n}\n\n/** The browse-profile gate's resume (`BrowseProfileApprovalResume`). */\nexport function browseProfileApprovalResume({\n  action,\n  forSession = false,\n}: {\n  action: 'approve' | 'reject';\n  /** On an approve: stop asking about these profiles for the rest of the thread. */\n  forSession?: boolean;\n}): Record<string, unknown> {\n  return action === 'approve' && forSession ? { action, scope: 'session' } : { action };\n}\n\nexport function isPmScheduleApprovalInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.PM_SCHEDULE_APPROVAL);\n}\n\n/** The project manager schedule a person approves (`pm_tools.py`). */\nexport interface PmScheduleApprovalContext {\n  /** `delete` for a deletion; anything else is a creation. */\n  readonly action: string | null;\n  /** The schedule's facts, in the card's order, by their context key. */\n  readonly fields: readonly (readonly [key: string, value: string])[];\n}\n\nconst PM_SCHEDULE_FIELDS = [\n  'project_asset_id',\n  'cron',\n  'timezone',\n  'summary',\n  'scheduled_for',\n  'schedule_id',\n] as const;\n\nexport function readPmScheduleApprovalContext(payload: TypedInterruptPayload): PmScheduleApprovalContext {\n  const { context } = payload;\n  // Only the facts the schedule has, as Olympus's card lists them.\n  const fields = PM_SCHEDULE_FIELDS.flatMap((key): (readonly [string, string])[] => {\n    const value = context[key];\n    return value ? [[key, String(value)]] : [];\n  });\n  return { action: optionalText(context.action), fields };\n}\n\n/** An approval's resume (`HITLResume`, `PMScheduleApprovalResume`): approve, or reject with a reason. */\nexport function typedApprovalResume({\n  action,\n  reason,\n}: {\n  action: 'approve' | 'reject';\n  reason?: string;\n}): Record<string, unknown> {\n  return reason ? { action, reason } : { action };\n}\n\nexport function isWaitForMinutesInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.WAIT_FOR_MINUTES);\n}\n\n/** The wait `wait_for_minutes` announced (`misc_tools.py`). */\nexport interface WaitForMinutesContext {\n  readonly minutes: number;\n  readonly reason: string | null;\n  /** The whole wait in seconds, when the raiser stamped it on the context. */\n  readonly timeoutSeconds: number | null;\n}\n\n/**\n * Each field on its own: the raiser sends `reason: null` for a wait without\n * one, which must not lose the minutes.\n */\nexport function readWaitForMinutesContext(payload: TypedInterruptPayload): WaitForMinutesContext {\n  const { minutes, reason, timeout_seconds: timeoutSeconds } = payload.context;\n  return {\n    minutes: isFiniteNumber(minutes) ? minutes : 0,\n    reason: isString(reason) && reason ? reason : null,\n    timeoutSeconds: isFiniteNumber(timeoutSeconds) ? timeoutSeconds : null,\n  };\n}\n\nexport function isRequestFileInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.REQUEST_FILE);\n}\n\n/** What `request_file_from_user` asks for (`misc_tools.py`). */\nexport interface RequestFileContext {\n  readonly prompt: string;\n  readonly allowMultiple: boolean;\n}\n\nexport function readRequestFileContext(payload: TypedInterruptPayload): RequestFileContext {\n  const { prompt, allow_multiple: allowMultiple } = payload.context;\n  return {\n    prompt: (isString(prompt) && prompt) || payload.message || 'Upload a file to continue.',\n    allowMultiple: allowMultiple === true,\n  };\n}\n\n/** One uploaded file of `request_file_from_user`'s resume (`RequestedFile`). */\nexport interface RequestedFile {\n  readonly asset_id: string;\n  readonly filename: string;\n  /** The `[@title](link)` mention the agent can quote. */\n  readonly mention: string | null;\n}\n\n/** The file request's resume (`RequestFileResume`). */\nexport function requestFileResume(files: readonly RequestedFile[]): Record<string, unknown> {\n  return {\n    files: files.map(({ asset_id, filename, mention }) => ({ asset_id, filename, mention })),\n  };\n}\n\n/** The gated call of a tool-raised HITL approval (`raise_hitl_interrupt`). */\nexport interface TypedHitlContext {\n  readonly toolId: string | null;\n  readonly toolCallId: string | null;\n  readonly toolArgs: Readonly<Record<string, unknown>>;\n  /** What the backend resolved about the call before asking (`approval_context`). */\n  readonly approvalContext: unknown;\n}\n\nexport function readTypedHitlContext(payload: TypedInterruptPayload): TypedHitlContext {\n  const { context } = payload;\n  return {\n    toolId: optionalText(context.tool_id),\n    toolCallId: optionalText(context.tool_call_id),\n    toolArgs: isRecord(context.tool_args) ? context.tool_args : {},\n    approvalContext: context.approval_context,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/typed-interrupts.cjs

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const interrupts = require("./interrupts.cjs");
+const TypedInterruptType = {
+  HITL: "hitl",
+  FORM_INPUT: "form_input",
+  CUSTOM: "custom"
+};
+const TYPED_INTERRUPT_TYPES = new Set(Object.values(TypedInterruptType));
+const TypedInterruptSource = {
+  ASK_QUESTIONNAIRE: "ask_questionnaire",
+  DEEP_RESEARCH_PENDING: "deep_research_pending",
+  PM_SCHEDULE_APPROVAL: "pm_schedule_approval",
+  WAIT_FOR_MINUTES: "wait_for_minutes",
+  BROWSE_PROFILE_APPROVAL: "browse_profile_approval",
+  TOOLKIT_SELECTION: "toolkit_selection",
+  REQUEST_FILE: "request_file"
+};
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isOptional(value, check) {
+  return value === void 0 || check(value);
+}
+const isString = (value) => typeof value === "string";
+const isBoolean = (value) => typeof value === "boolean";
+const isFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value);
+function parseTypedInterruptPayload(value) {
+  if (!isRecord(value)) return null;
+  const { source, type, origin, message, timestamp, context } = value;
+  if (!isString(source) || !isString(type) || !TYPED_INTERRUPT_TYPES.has(type)) return null;
+  if (!isString(origin) || !isString(message) || !isFiniteNumber(timestamp)) return null;
+  if (!isOptional(value.requires_user_action, isBoolean) || !isOptional(value.timeout_seconds, isFiniteNumber) || !isOptional(value.timeout_at, isString) || !isOptional(value.timeout_default_value, isRecord) || !isOptional(value.interrupt_instance_id, isString)) {
+    return null;
+  }
+  return { ...value, context: isRecord(context) ? context : {} };
+}
+function isTypedInterruptRequest(request) {
+  if (!interrupts.isApprovalCardInterrupt(request)) return false;
+  const payload = request.payload;
+  if (interrupts.asHitlApproval(payload) !== null) return false;
+  return parseTypedInterruptPayload(payload) !== null;
+}
+exports.TypedInterruptSource = TypedInterruptSource;
+exports.TypedInterruptType = TypedInterruptType;
+exports.isTypedInterruptRequest = isTypedInterruptRequest;
+exports.parseTypedInterruptPayload = parseTypedInterruptPayload;
+//# sourceMappingURL=typed-interrupts.cjs.map

package/dist/agent-runtime/src/typed-interrupts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-interrupts.cjs","sources":["../../../../agent-runtime/src/typed-interrupts.ts"],"sourcesContent":["/**\n * The typed Athena interrupts: what a tool parks a run on through agora's\n * `raise_hitl_interrupt`, `raise_form_interrupt` and `raise_custom_interrupt`\n * (`agora/services/interrupts/utils.py`), each answered with the resume shape\n * its raiser validates (`agora/services/interrupts/definitions.py`). The\n * deepagents `hitl_approval` park is not one of them: the approval card\n * answers that (`asHitlApproval`).\n *\n * This module is the payload contract's selector, which every chat carries:\n * which parks are typed (`isTypedInterruptRequest`, the one selector) and the\n * payload they carry. What a card needs beyond it (each kind's reader and\n * resume, which answers approve, the stale-resume stamps, the timer) is\n * `typed-interrupt-kinds.ts`, kept apart so a host's startup bundle carries only\n * the selector while the cards load later. Both mirror Olympus's\n * `config/interruptDefinitions.ts` field for field (a payload either side calls\n * typed, the other does too) without zod, which the React SDK's published\n * bundle may not carry. Rendering stays with each surface.\n */\n\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { asHitlApproval, isApprovalCardInterrupt } from './interrupts';\n\n/** The three types the server raises (`InterruptType` in `definitions.py`). */\nexport const TypedInterruptType = {\n  HITL: 'hitl',\n  FORM_INPUT: 'form_input',\n  CUSTOM: 'custom',\n} as const;\n\nexport type TypedInterruptType = (typeof TypedInterruptType)[keyof typeof TypedInterruptType];\n\nconst TYPED_INTERRUPT_TYPES: ReadonlySet<string> = new Set(Object.values(TypedInterruptType));\n\n/** The `custom` sources a surface has a card of its own for (`interrupt_id` at the raise site). */\nexport const TypedInterruptSource = {\n  ASK_QUESTIONNAIRE: 'ask_questionnaire',\n  DEEP_RESEARCH_PENDING: 'deep_research_pending',\n  PM_SCHEDULE_APPROVAL: 'pm_schedule_approval',\n  WAIT_FOR_MINUTES: 'wait_for_minutes',\n  BROWSE_PROFILE_APPROVAL: 'browse_profile_approval',\n  TOOLKIT_SELECTION: 'toolkit_selection',\n  REQUEST_FILE: 'request_file',\n} as const;\n\nexport type TypedInterruptSource = (typeof TypedInterruptSource)[keyof typeof TypedInterruptSource];\n\n/** A parked typed interrupt, as the raiser published it. */\nexport interface TypedInterruptPayload {\n  /** The interrupt id: `ask_questionnaire`, `toolkit_selection`, `hitl_<tool>`, a form id… */\n  readonly source: string;\n  readonly type: TypedInterruptType;\n  /** Who raised it (`tool:ask`, `tool:toggle_toolkit`…). */\n  readonly origin: string;\n  readonly message: string;\n  /** The kind's own fields (questions, toolkits, the gated call…); `{}` when the raiser sent none. */\n  readonly context: Readonly<Record<string, unknown>>;\n  readonly timestamp: number;\n  /** The resume model's JSON Schema (a form's fields). */\n  readonly schema?: unknown;\n  /** `false` on a system pause nobody answers (a background research wait). */\n  readonly requires_user_action?: boolean;\n  readonly timeout_seconds?: number;\n  /** When the backend's timer answers for the person (ISO 8601 UTC). */\n  readonly timeout_at?: string;\n  readonly timeout_default_value?: Readonly<Record<string, unknown>>;\n  /** The instance the raiser's stale-resume check compares (HITL parks carry it). */\n  readonly interrupt_instance_id?: string;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isOptional<T>(value: unknown, check: (candidate: unknown) => candidate is T): boolean {\n  return value === undefined || check(value);\n}\n\nconst isString = (value: unknown): value is string => typeof value === 'string';\nconst isBoolean = (value: unknown): value is boolean => typeof value === 'boolean';\nconst isFiniteNumber = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isFinite(value);\n\n/**\n * The payload as a typed interrupt, or `null` when it is not one. Reads what\n * Olympus's `InterruptPayloadSchema` reads, with the same required fields\n * (`source`, `type`, `origin`, `message`, `timestamp`) and the same optional\n * ones, so a park is typed on every surface or on none. A missing or malformed\n * `context` reads as `{}`, as the schema's `.catch({})` does.\n */\nexport function parseTypedInterruptPayload(value: unknown): TypedInterruptPayload | null {\n  if (!isRecord(value)) return null;\n  const { source, type, origin, message, timestamp, context } = value;\n  if (!isString(source) || !isString(type) || !TYPED_INTERRUPT_TYPES.has(type)) return null;\n  if (!isString(origin) || !isString(message) || !isFiniteNumber(timestamp)) return null;\n  if (\n    !isOptional(value.requires_user_action, isBoolean) ||\n    !isOptional(value.timeout_seconds, isFiniteNumber) ||\n    !isOptional(value.timeout_at, isString) ||\n    !isOptional(value.timeout_default_value, isRecord) ||\n    !isOptional(value.interrupt_instance_id, isString)\n  ) {\n    return null;\n  }\n  return { ...value, context: isRecord(context) ? context : {} } as unknown as TypedInterruptPayload;\n}\n\n/**\n * The one selector for \"a pending park a typed card answers\": an approval-card\n * interrupt (neither a client tool's park nor a system pause), not the\n * deepagents HITL approval the approval card answers, and parsing as a typed\n * interrupt. The card renders for the request this selects and its answer is\n * sent under that same request.\n */\nexport function isTypedInterruptRequest(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  if (!isApprovalCardInterrupt(request)) return false;\n  const payload: unknown = (request as { payload?: unknown }).payload;\n  if (asHitlApproval(payload) !== null) return false;\n  return parseTypedInterruptPayload(payload) !== null;\n}\n"],"names":["isApprovalCardInterrupt","asHitlApproval"],"mappings":";;;AAuBO,MAAM,qBAAqB;AAAA,EAChC,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,QAAQ;AACV;AAIA,MAAM,wBAA6C,IAAI,IAAI,OAAO,OAAO,kBAAkB,CAAC;AAGrF,MAAM,uBAAuB;AAAA,EAClC,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,sBAAsB;AAAA,EACtB,kBAAkB;AAAA,EAClB,yBAAyB;AAAA,EACzB,mBAAmB;AAAA,EACnB,cAAc;AAChB;AA2BA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,WAAc,OAAgB,OAAwD;AAC7F,SAAO,UAAU,UAAa,MAAM,KAAK;AAC3C;AAEA,MAAM,WAAW,CAAC,UAAoC,OAAO,UAAU;AACvE,MAAM,YAAY,CAAC,UAAqC,OAAO,UAAU;AACzE,MAAM,iBAAiB,CAAC,UACtB,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK;AAS7C,SAAS,2BAA2B,OAA8C;AACvF,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,EAAE,QAAQ,MAAM,QAAQ,SAAS,WAAW,YAAY;AAC9D,MAAI,CAAC,SAAS,MAAM,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,sBAAsB,IAAI,IAAI,EAAG,QAAO;AACrF,MAAI,CAAC,SAAS,MAAM,KAAK,CAAC,SAAS,OAAO,KAAK,CAAC,eAAe,SAAS,EAAG,QAAO;AAClF,MACE,CAAC,WAAW,MAAM,sBAAsB,SAAS,KACjD,CAAC,WAAW,MAAM,iBAAiB,cAAc,KACjD,CAAC,WAAW,MAAM,YAAY,QAAQ,KACtC,CAAC,WAAW,MAAM,uBAAuB,QAAQ,KACjD,CAAC,WAAW,MAAM,uBAAuB,QAAQ,GACjD;AACA,WAAO;AAAA,EACT;AACA,SAAO,EAAE,GAAG,OAAO,SAAS,SAAS,OAAO,IAAI,UAAU,GAAC;AAC7D;AASO,SAAS,wBACd,SAC+C;AAC/C,MAAI,CAACA,WAAAA,wBAAwB,OAAO,EAAG,QAAO;AAC9C,QAAM,UAAoB,QAAkC;AAC5D,MAAIC,0BAAe,OAAO,MAAM,KAAM,QAAO;AAC7C,SAAO,2BAA2B,OAAO,MAAM;AACjD;;;;;"}

package/dist/agent-runtime/src/typed-interrupts.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The typed Athena interrupts: what a tool parks a run on through agora's
+ * `raise_hitl_interrupt`, `raise_form_interrupt` and `raise_custom_interrupt`
+ * (`agora/services/interrupts/utils.py`), each answered with the resume shape
+ * its raiser validates (`agora/services/interrupts/definitions.py`). The
+ * deepagents `hitl_approval` park is not one of them: the approval card
+ * answers that (`asHitlApproval`).
+ *
+ * This module is the payload contract's selector, which every chat carries:
+ * which parks are typed (`isTypedInterruptRequest`, the one selector) and the
+ * payload they carry. What a card needs beyond it (each kind's reader and
+ * resume, which answers approve, the stale-resume stamps, the timer) is
+ * `typed-interrupt-kinds.ts`, kept apart so a host's startup bundle carries only
+ * the selector while the cards load later. Both mirror Olympus's
+ * `config/interruptDefinitions.ts` field for field (a payload either side calls
+ * typed, the other does too) without zod, which the React SDK's published
+ * bundle may not carry. Rendering stays with each surface.
+ */
+import type { StatewireThread } from '@assistant-ui/react-statewire';
+/** The three types the server raises (`InterruptType` in `definitions.py`). */
+export declare const TypedInterruptType: {
+    readonly HITL: 'hitl';
+    readonly FORM_INPUT: 'form_input';
+    readonly CUSTOM: 'custom';
+};
+export type TypedInterruptType = (typeof TypedInterruptType)[keyof typeof TypedInterruptType];
+/** The `custom` sources a surface has a card of its own for (`interrupt_id` at the raise site). */
+export declare const TypedInterruptSource: {
+    readonly ASK_QUESTIONNAIRE: 'ask_questionnaire';
+    readonly DEEP_RESEARCH_PENDING: 'deep_research_pending';
+    readonly PM_SCHEDULE_APPROVAL: 'pm_schedule_approval';
+    readonly WAIT_FOR_MINUTES: 'wait_for_minutes';
+    readonly BROWSE_PROFILE_APPROVAL: 'browse_profile_approval';
+    readonly TOOLKIT_SELECTION: 'toolkit_selection';
+    readonly REQUEST_FILE: 'request_file';
+};
+export type TypedInterruptSource = (typeof TypedInterruptSource)[keyof typeof TypedInterruptSource];
+/** A parked typed interrupt, as the raiser published it. */
+export interface TypedInterruptPayload {
+    /** The interrupt id: `ask_questionnaire`, `toolkit_selection`, `hitl_<tool>`, a form id… */
+    readonly source: string;
+    readonly type: TypedInterruptType;
+    /** Who raised it (`tool:ask`, `tool:toggle_toolkit`…). */
+    readonly origin: string;
+    readonly message: string;
+    /** The kind's own fields (questions, toolkits, the gated call…); `{}` when the raiser sent none. */
+    readonly context: Readonly<Record<string, unknown>>;
+    readonly timestamp: number;
+    /** The resume model's JSON Schema (a form's fields). */
+    readonly schema?: unknown;
+    /** `false` on a system pause nobody answers (a background research wait). */
+    readonly requires_user_action?: boolean;
+    readonly timeout_seconds?: number;
+    /** When the backend's timer answers for the person (ISO 8601 UTC). */
+    readonly timeout_at?: string;
+    readonly timeout_default_value?: Readonly<Record<string, unknown>>;
+    /** The instance the raiser's stale-resume check compares (HITL parks carry it). */
+    readonly interrupt_instance_id?: string;
+}
+/**
+ * The payload as a typed interrupt, or `null` when it is not one. Reads what
+ * Olympus's `InterruptPayloadSchema` reads, with the same required fields
+ * (`source`, `type`, `origin`, `message`, `timestamp`) and the same optional
+ * ones, so a park is typed on every surface or on none. A missing or malformed
+ * `context` reads as `{}`, as the schema's `.catch({})` does.
+ */
+export declare function parseTypedInterruptPayload(value: unknown): TypedInterruptPayload | null;
+/**
+ * The one selector for "a pending park a typed card answers": an approval-card
+ * interrupt (neither a client tool's park nor a system pause), not the
+ * deepagents HITL approval the approval card answers, and parsing as a typed
+ * interrupt. The card renders for the request this selects and its answer is
+ * sent under that same request.
+ */
+export declare function isTypedInterruptRequest(request: StatewireThread.InputRequestState): request is StatewireThread.CustomInputRequest;