@keystrokehq/keystroke 0.0.0-staging-20260714181321

package/dist/index-CX3Pvwnv.d.cts

@@ -0,0 +1,388 @@
+import { C as PromptLlmRunOptions, O as WorkflowEventType, T as ResolvedCredentials, d as CredentialList, l as CredentialConsumer, m as CredentialScopeType, p as CredentialRunContext, t as AgentTool, v as FilePart, x as OAuthTokenAdapter } from "./index-whyhiCRD.cjs";
+import { c as WorkflowActionDefinition, i as McpCredentialContext, r as AgentRunOptions, t as ActionDefinition } from "./index-DO4QkV10.cjs";
+import { z } from "zod";
+
+//#region ../workflow/dist/index.d.mts
+//#region src/run-canceled-error.d.ts
+declare class RunCanceledError extends Error {
+  constructor(runId?: string);
+}
+declare function isRunCanceledError(error: unknown): error is RunCanceledError; //#endregion
+//#region src/run-timeout-error.d.ts
+type RunTimeoutKind = "agent" | "workflow" | "poll";
+declare class RunTimeoutError extends Error {
+  readonly kind: RunTimeoutKind;
+  readonly timeoutMs: number;
+  constructor(kind: RunTimeoutKind, timeoutMs: number);
+}
+declare function isRunTimeoutError(error: unknown): error is RunTimeoutError; //#endregion
+//#region src/types.d.ts
+type RunnableAction<TInput, TOutput, TCredentials = Record<string, never>> = ActionDefinition<TInput, TOutput, TCredentials> | WorkflowActionDefinition<TInput, TOutput, TCredentials, CredentialList | undefined>;
+type ActionRunOptions = {
+  /** Build-injected structural call-site id (internal; lines runs up with the canvas). */callSiteId?: string;
+  credentialScope?: CredentialScopeType;
+};
+type ActionRunner = <TInput, TOutput, TCredentials = Record<string, never>>(action: RunnableAction<TInput, TOutput, TCredentials>, input: TInput, options?: ActionRunOptions) => Promise<TOutput>;
+type ActionRunnerOptions = {
+  resolveCredentials?: <T extends CredentialList>(requirements: T, consumer: CredentialConsumer, contextOverride?: Partial<CredentialRunContext>) => Promise<ResolvedCredentials<T>>;
+  credentialContext?: CredentialRunContext;
+  oauthAdapter?: OAuthTokenAdapter;
+  mcpCredentialContext?: McpCredentialContext;
+};
+type AgentRunner = (agent: unknown, input: {
+  message: string;
+  sessionId?: string;
+  agentId?: string;
+  outputSchema?: z.ZodType;
+}, options?: AgentRunOptions) => Promise<unknown>;
+/** Runs another workflow as a durable, IO-validated step inside the current run. */
+type WorkflowStepRunner = (workflow: unknown, input: unknown, options?: {
+  callSiteId?: string;
+}) => Promise<unknown>;
+/** Host-supplied prompt execution for agent steps (`executeWorkflow({ runAgent })`). */
+type AgentStepExecutor = (agent: unknown, input: {
+  message: string;
+  sessionId?: string;
+  agentId?: string;
+  outputSchema?: z.ZodType;
+}, runPrompt?: Record<string, unknown>) => Promise<unknown>;
+/** Host-supplied LLM execution for `promptLlm` steps (`executeWorkflow({ runLlm })`). */
+type LlmStepExecutor = (opts: PromptLlmRunOptions) => Promise<unknown>;
+type LlmRunner = (opts: PromptLlmRunOptions) => Promise<unknown>;
+type SleepDuration = number | string | Date;
+type WorkflowSleep = (duration: SleepDuration, options?: {
+  __site?: string;
+}) => Promise<void>;
+type HookOptions<T> = {
+  /** Reuse a stable token instead of generating one. */token?: string; /** Optional schema to validate the resume payload. */
+  schema?: z.ZodType<T>; /** Build-injected structural call-site id (internal; lines runs up with the canvas). */
+  __site?: string;
+};
+/** Awaitable handle returned by `ctx.hook()`; awaiting it suspends until resumed. */
+type HookHandle<T> = PromiseLike<T> & {
+  token: string;
+  resumeUrl: string;
+};
+type WorkflowHook = <T = unknown>(options?: HookOptions<T>) => HookHandle<T>;
+type WorkflowRunContext = {
+  runId: string;
+  workspacesRoot?: string;
+  trigger?: "api" | "cron" | "webhook" | "poll" | "retry";
+  triggeredAt?: Date; /** Durably suspend the run for a duration (or until a Date). */
+  sleep: WorkflowSleep; /** Create a resume token and suspend the run until it is resumed externally. */
+  hook: WorkflowHook;
+}; //#endregion
+//#region src/workflow-definition.d.ts
+/** Runtime validation for an unbranded workflow definition. */
+declare const workflowCoreSchema: z.ZodObject<{
+  slug: z.ZodString;
+  name: z.ZodString;
+  description: z.ZodString;
+  subscription: z.ZodOptional<z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+      system: "system";
+      subscribable: "subscribable";
+    }>>;
+  }, z.core.$strip>>;
+  input: z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+  output: z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+  run: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+}, z.core.$strip>;
+/** Non-IO fields derived from the schema. Schema is the source of truth. */
+type WorkflowMeta = Omit<z.infer<typeof workflowCoreSchema>, "input" | "output" | "run">;
+type WorkflowIO<TInputSchema extends z.ZodType, TOutputSchema extends z.ZodType> = {
+  input: TInputSchema;
+  output: TOutputSchema;
+  run(input: z.infer<TInputSchema>, ctx: WorkflowRunContext): Promise<z.infer<TOutputSchema>>;
+};
+declare const WORKFLOW: unique symbol;
+/**
+ * Lazy, awaitable handle returned by `workflow.run(input)` inside another
+ * workflow. Awaiting it runs the sub-workflow as a durable, IO-validated step.
+ */
+type WorkflowStepInvocation<TOutput> = {
+  /**
+   * Internal: stamps the build-injected structural call-site id onto the
+   * sub-workflow step so its correlation id matches the canvas graph node.
+   * Emitted by the deploy build transform, never written by users.
+   */
+  __site(callSiteId: string): WorkflowStepInvocation<TOutput>;
+  then<TResult1 = TOutput, TResult2 = never>(onfulfilled?: ((value: TOutput) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+};
+/**
+ * Stored shape of a workflow after `defineWorkflow`. Parametrized by the
+ * inferred input/output types so consumers can write `WorkflowDefinition<unknown, unknown>`.
+ *
+ * `run` is declared with method shorthand (not a function-typed property) so it's checked
+ * bivariantly, matching `WorkflowDefinition<TInput, TOutput>` assignability to
+ * `WorkflowDefinition<unknown, unknown>` (e.g. trigger attachments) the same as before the
+ * durable workflow-as-step overload was added.
+ *
+ * Overloaded: the engine (and tests) call `run(input, ctx)` to execute the body directly;
+ * inside another workflow, `run(input)` returns a durable step (same pattern as `defineAction`).
+ */
+type WorkflowDefinition<TInput = unknown, TOutput = unknown> = WorkflowMeta & {
+  input: z.ZodType<TInput>;
+  output: z.ZodType<TOutput>;
+  run(input: TInput, ctx: WorkflowRunContext): Promise<TOutput>;
+  run(input: TInput): WorkflowStepInvocation<TOutput>;
+  readonly [WORKFLOW]: true;
+};
+/**
+ * Authoring shape for `defineWorkflow`. Parametrized by Zod *schemas* (not
+ * inferred types) so `run()` can infer its input and output from `input`/`output`.
+ */
+type WorkflowDefinitionInput<TInputSchema extends z.ZodType = z.ZodType, TOutputSchema extends z.ZodType = z.ZodType> = WorkflowMeta & WorkflowIO<TInputSchema, TOutputSchema>;
+/**
+ * Validates brand + shape via `workflowCoreSchema` so discovery and guards
+ * reject malformed definitions.
+ */
+declare function isWorkflow(value: unknown): value is WorkflowDefinition; //#endregion
+//#region src/define-workflow.d.ts
+declare function defineWorkflow<TInputSchema extends z.ZodType, TOutputSchema extends z.ZodType>(def: WorkflowDefinitionInput<TInputSchema, TOutputSchema>): WorkflowDefinition<z.infer<TInputSchema>, z.infer<TOutputSchema>>; //#endregion
+//#region src/replay/types.d.ts
+/** Structural shape of a persisted event row (matches @keystrokehq/database). */
+type ReplayEvent = {
+  id: string;
+  runId: string;
+  seq: number;
+  type: WorkflowEventType;
+  correlationId: string | null;
+  data: unknown;
+};
+type AppendEventInput = {
+  id?: string;
+  runId: string;
+  type: WorkflowEventType;
+  correlationId?: string | null;
+  data?: unknown;
+};
+/** Injected durable log (DB-backed in the server, in-memory in tests). */
+type DurableEventLog = {
+  append(event: AppendEventInput): Promise<boolean>;
+  listReplay(runId: string): Promise<ReplayEvent[]>;
+};
+type SleepPendingItem = {
+  kind: "sleep";
+  correlationId: string;
+  resumeAt: Date;
+};
+type HookPendingItem = {
+  kind: "hook";
+  correlationId: string;
+  token: string; /** Serialized JSON Schema for the resume payload, when the hook declared one. */
+  schema?: Record<string, unknown>;
+};
+type WorkflowChildPendingItem = {
+  kind: "child";
+  childKind: "workflow";
+  correlationId: string;
+  targetId: string;
+  input: unknown; /** The parent event log already contains a dispatch record for this child. */
+  dispatched: boolean;
+};
+type AgentChildPendingItem = {
+  kind: "child";
+  childKind: "agent";
+  correlationId: string;
+  targetId: string;
+  input: {
+    message: string;
+    sessionId?: string;
+    agentId?: string;
+    outputSchema?: import("zod").ZodType;
+    files?: FilePart[];
+  };
+  runPrompt?: Record<string, unknown>; /** The parent event log already contains a dispatch record for this child. */
+  dispatched: boolean;
+};
+type ChildPendingItem = WorkflowChildPendingItem | AgentChildPendingItem;
+type PendingItem = SleepPendingItem | HookPendingItem | ChildPendingItem;
+type ReplayResult = {
+  status: "completed";
+  output: unknown;
+} | {
+  status: "failed";
+  error: unknown;
+  failedCorrelationId?: string;
+} | {
+  status: "canceled";
+} | {
+  status: "suspended";
+  items: PendingItem[];
+}; //#endregion
+//#region src/execute-workflow.d.ts
+type ExecuteWorkflowOptions = {
+  runId?: string; /** Durable event log. Defaults to an in-memory log (single, non-resumable pass). */
+  eventLog?: DurableEventLog;
+  resolveCredentials?: ActionRunnerOptions["resolveCredentials"];
+  credentialContext?: ActionRunnerOptions["credentialContext"];
+  oauthAdapter?: ActionRunnerOptions["oauthAdapter"]; /** Public project-scoped base URL for hook resume (`…/api/projects/:id`). */
+  hookBaseUrl?: string; /** Captured once per pass; primitives use this for deterministic time math. */
+  now?: Date;
+  context?: Partial<Omit<WorkflowRunContext, "runId" | "sleep" | "hook">>; /** Executes agent prompt steps; when omitted, `agent.prompt()` falls back to direct execution. */
+  runAgent?: AgentStepExecutor; /** Executes `promptLlm` steps; when omitted, `promptLlm()` throws at runtime. */
+  runLlm?: LlmStepExecutor; /** Suspend workflow/agent child steps for host-managed queue dispatch. */
+  queueChildSteps?: boolean;
+};
+/**
+ * The single way to run a workflow: replay its event log from the top, execute
+ * un-cached primitives, and either complete/fail or suspend at the first
+ * un-satisfied sleep/hook. New events (sleep_scheduled/sleep_completed/
+ * hook_created/run_completed/run_failed) are flushed before returning.
+ *
+ * Durability comes entirely from the log — a suspended run resumes by calling
+ * this again with the same `runId` and event log once the sleep is due or the
+ * hook is resumed.
+ */
+declare function executeWorkflow<TInput, TOutput>(workflow: WorkflowDefinition<TInput, TOutput>, input: unknown, options?: ExecuteWorkflowOptions): Promise<ReplayResult>; //#endregion
+//#region src/replay/events-consumer.d.ts
+type StepResult = {
+  completed: true;
+  result: unknown;
+} | {
+  completed: false;
+};
+/** Indexes replay events by correlationId for O(1) cache-hit checks during replay. */
+declare class EventsConsumer {
+  private readonly byCorrelationId;
+  constructor(events: ReplayEvent[]);
+  private events;
+  hasEventType(correlationId: string, type: ReplayEvent["type"]): boolean;
+  /**
+   * Cache lookup for a step. Returns the recorded output on a `step_completed`,
+   * re-raises the recorded error on a terminal `step_failed` (so a permanently
+   * failed step is not re-executed), and otherwise reports a miss — including
+   * when only `step_retrying` events exist (the step re-runs on the next pass).
+   */
+  getStepResult(correlationId: string): StepResult;
+  /** Number of prior `step_retrying` events recorded for a step (= failed attempts so far). */
+  countRetrying(correlationId: string): number;
+  isSleepCompleted(correlationId: string): boolean;
+  /** Returns the persisted resumeAt for a scheduled-but-not-completed sleep, if any. */
+  getSleepResumeAt(correlationId: string): Date | undefined;
+  getHookToken(correlationId: string): string | undefined;
+  getHookResult(correlationId: string): {
+    resolved: true;
+    payload: unknown;
+  } | {
+    resolved: false;
+  };
+} //#endregion
+//#region src/replay/suspension.d.ts
+/**
+ * Collects pending items requested within a single tick and resolves once, so
+ * parallel suspensions (e.g. Promise.all of two sleeps) batch into one suspension.
+ */
+declare class SuspensionCoordinator {
+  private readonly items;
+  private scheduled;
+  private resolve;
+  private readonly promise;
+  constructor();
+  request(item: PendingItem): void;
+  waitForSuspension(): Promise<PendingItem[]>;
+} //#endregion
+//#region src/replay/replay-context.d.ts
+type ReplayState = {
+  runId: string;
+  consumer: EventsConsumer;
+  coordinator: SuspensionCoordinator;
+  eventLog: DurableEventLog;
+  newEvents: AppendEventInput[];
+  now: Date;
+  hookBaseUrl?: string;
+  sleepCounter: number;
+  hookCounter: number;
+  stepOccurrences: Map<string, number>;
+  failedCorrelationId?: string;
+}; //#endregion
+//#region src/create-action-runner.d.ts
+/** Non-durable action runner for poll sources and other ephemeral orchestration. */
+declare function createDirectActionRunner(options?: ActionRunnerOptions): ActionRunner;
+/** Builds the per-run action runner; durability lives in {@link runDurableStep}. */
+declare function createActionRunner(state: ReplayState, options?: ActionRunnerOptions): ActionRunner; //#endregion
+//#region src/run-context.d.ts
+type WorkflowRunStore = {
+  actionRunner: ActionRunner;
+  agentRunner?: AgentRunner;
+  llmRunner?: LlmRunner;
+  workflowRunner?: WorkflowStepRunner;
+  runId: string;
+};
+declare function runWithWorkflowContext<T>(store: WorkflowRunStore, fn: () => Promise<T>): Promise<T>; //#endregion
+//#region src/prompt-llm.d.ts
+type PromptLlmOptions<S extends z.ZodType | undefined = undefined> = Omit<PromptLlmRunOptions, "prompt" | "outputSchema"> & {
+  outputSchema?: S;
+};
+declare function promptLlm<S extends z.ZodType | undefined = undefined>(prompt: string, opts: PromptLlmOptions<S>): Promise<S extends z.ZodType ? z.infer<S> : string>; //#endregion
+//#region src/replay/memory-event-log.d.ts
+/** In-memory durable log for inline execution and tests. */
+declare class MemoryEventLog implements DurableEventLog {
+  private readonly events;
+  private readonly ids;
+  append(event: AppendEventInput): Promise<boolean>;
+  listReplay(runId: string): Promise<ReplayEvent[]>;
+} //#endregion
+//#region src/replay/error.d.ts
+/** Serializable shape for a recorded step/run error (stored in event data). */
+type SerializedWorkflowError = {
+  name?: string;
+  message: string;
+};
+declare function serializeWorkflowError(error: unknown): SerializedWorkflowError;
+/** Rebuild an Error from a recorded error so replay re-raises the same failure. */
+declare function deserializeWorkflowError(data: unknown): Error; //#endregion
+//#region src/workflow-tool.d.ts
+/**
+ * Parent execution context threaded from an agent into a workflow invoked as a
+ * tool, so the nested run resolves credentials the same way a direct run does.
+ */
+type WorkflowToolContext = {
+  credentials?: Partial<CredentialRunContext>;
+  oauthAdapter?: OAuthTokenAdapter;
+  actor?: {
+    userId?: string;
+  };
+  parentAgent?: {
+    sessionId: string;
+    agentId: string;
+    agentKey?: string;
+  };
+  queueWorkflowTool?: QueuedWorkflowToolExecutor;
+};
+type WorkflowToolExecutorOptions = WorkflowToolContext & {
+  workflowKey?: string;
+  signal?: AbortSignal;
+};
+type QueuedWorkflowToolExecutor = (workflow: WorkflowDefinition<unknown, unknown>, input: unknown, options: WorkflowToolExecutorOptions) => Promise<unknown>;
+type WorkflowToolExecutor = (workflow: WorkflowDefinition<unknown, unknown>, input: unknown, options: WorkflowToolExecutorOptions) => Promise<unknown>;
+declare function registerWorkflowToolExecutor(fn: WorkflowToolExecutor): void;
+declare function resolveWorkflowTool(workflow: WorkflowDefinition<unknown, unknown>, context?: WorkflowToolContext): AgentTool; //#endregion
+//#region src/file-store-registry.d.ts
+type FileStore = {
+  /** Optional fallback when ALS project scope is unavailable (e.g. unit tests). */projectId?: string;
+  putObject: (input: {
+    key: string;
+    body: Uint8Array | Buffer | string;
+    contentType?: string;
+  }) => Promise<void>;
+};
+declare function registerFileStore(store: FileStore | undefined): void; //#endregion
+//#region src/store-file.d.ts
+type StoreFileOptions = {
+  mediaType: string;
+  filename?: string;
+};
+/**
+ * Persist raw bytes into org chat-attachment storage and return a `FilePart` ref
+ * that can travel through workflow input / step checkpoints / `agent.prompt({ files })`.
+ *
+ * Requires worker storage (`registerFileStore`) and a bound project scope.
+ * Serve path uses a `workflow` agent-slug placeholder — hydration ignores it.
+ * ponytail: web serving of workflow-stored files via the per-agent GET route is not wired.
+ */
+declare function storeFile(data: Uint8Array, options: StoreFileOptions): Promise<FilePart>; //#endregion
+//#endregion
+export { WorkflowStepInvocation as A, isRunTimeoutError as B, SleepPendingItem as C, WorkflowHook as D, WorkflowDefinition as E, createDirectActionRunner as F, resolveWorkflowTool as G, promptLlm as H, defineWorkflow as I, storeFile as J, runWithWorkflowContext as K, deserializeWorkflowError as L, WorkflowToolExecutor as M, WorkflowToolExecutorOptions as N, WorkflowRunContext as O, createActionRunner as P, executeWorkflow as R, SleepDuration as S, WorkflowChildPendingItem as T, registerFileStore as U, isWorkflow as V, registerWorkflowToolExecutor as W, ReplayResult as _, DurableEventLog as a, RunTimeoutKind as b, HookHandle as c, LlmStepExecutor as d, MemoryEventLog as f, ReplayEvent as g, QueuedWorkflowToolExecutor as h, ChildPendingItem as i, WorkflowToolContext as j, WorkflowSleep as k, HookOptions as l, PromptLlmOptions as m, AgentStepExecutor as n, ExecuteWorkflowOptions as o, PendingItem as p, serializeWorkflowError as q, AppendEventInput as r, FileStore as s, AgentChildPendingItem as t, HookPendingItem as u, RunCanceledError as v, StoreFileOptions as w, SerializedWorkflowError as x, RunTimeoutError as y, isRunCanceledError as z };
+//# sourceMappingURL=index-CX3Pvwnv.d.cts.map

package/dist/index-CX3Pvwnv.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-CX3Pvwnv.d.cts","names":["z","ActionDefinition","AgentRunOptions","CredentialList","CredentialScopeType","McpCredentialContext","ResolvedCredentials","WorkflowActionDefinition","AgentTool","CredentialConsumer","CredentialRunContext","FilePart","OAuthTokenAdapter","PromptLlmRunOptions","PromptLlmThinkingLevel","WorkflowEventType","RunCanceledError","Error","constructor","runId","isRunCanceledError","error","RunTimeoutKind","RunTimeoutError","kind","timeoutMs","isRunTimeoutError","RunnableAction","TInput","TOutput","TCredentials","Record","ActionRunOptions","callSiteId","credentialScope","ActionRunner","Promise","action","input","options","ActionRunnerOptions","T","Partial","resolveCredentials","requirements","consumer","contextOverride","credentialContext","oauthAdapter","mcpCredentialContext","AgentRunner","ZodType","agent","message","sessionId","agentId","outputSchema","WorkflowStepRunner","workflow","AgentStepExecutor","runPrompt","LlmStepExecutor","opts","LlmRunner","SleepDuration","Date","WorkflowSleep","duration","__site","HookOptions","token","schema","HookHandle","PromiseLike","resumeUrl","WorkflowHook","WorkflowRunContext","workspacesRoot","trigger","triggeredAt","sleep","hook","workflowCoreSchema","ZodString","ZodEnum","ZodOptional","core","$strip","ZodObject","$ZodTypeInternals","ZodCustom","$ZodFunctionArgs","$ZodFunctionOut","ZodFunction","slug","name","description","subscription","mode","system","subscribable","output","run","WorkflowMeta","infer","Omit","WorkflowIO","TInputSchema","TOutputSchema","ctx","WORKFLOW","WorkflowStepInvocation","TResult1","TResult2","then","value","onfulfilled","reason","onrejected","WorkflowDefinition","WorkflowDefinitionInput","isWorkflow","defineWorkflow","def","ReplayEvent","id","seq","type","correlationId","data","AppendEventInput","DurableEventLog","append","event","listReplay","SleepPendingItem","resumeAt","HookPendingItem","WorkflowChildPendingItem","childKind","targetId","dispatched","AgentChildPendingItem","_$_keystrokehq_shared0","files","ChildPendingItem","PendingItem","ReplayResult","status","failedCorrelationId","items","ExecuteWorkflowOptions","eventLog","hookBaseUrl","now","context","runAgent","runLlm","queueChildSteps","executeWorkflow","StepResult","completed","result","EventsConsumer","byCorrelationId","events","hasEventType","getStepResult","countRetrying","isSleepCompleted","getSleepResumeAt","getHookToken","getHookResult","resolved","payload","SuspensionCoordinator","scheduled","resolve","promise","request","item","waitForSuspension","ReplayState","Map","coordinator","newEvents","sleepCounter","hookCounter","stepOccurrences","createDirectActionRunner","createActionRunner","state","WorkflowRunStore","actionRunner","agentRunner","llmRunner","workflowRunner","runWithWorkflowContext","store","fn","PromptLlmOptions","S","promptLlm","prompt","MemoryEventLog","ids","SerializedWorkflowError","serializeWorkflowError","deserializeWorkflowError","WorkflowToolContext","QueuedWorkflowToolExecutor","credentials","actor","userId","parentAgent","agentKey","queueWorkflowTool","WorkflowToolExecutorOptions","AbortSignal","workflowKey","signal","WorkflowToolExecutor","registerWorkflowToolExecutor","resolveWorkflowTool","FileStore","Uint8Array","Buffer","projectId","putObject","key","body","contentType","registerFileStore","StoreFileOptions","mediaType","filename","storeFile"],"sources":["../../workflow/dist/index.d.mts"],"mappings":"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"}

package/dist/index-DO4QkV10.d.cts

@@ -0,0 +1,167 @@
+import { T as ResolvedCredentials, d as CredentialList, l as CredentialConsumer, m as CredentialScopeType, s as CredentialAssignmentTargetType, t as AgentTool, u as CredentialInput, v as FilePart } from "./index-whyhiCRD.cjs";
+import { z } from "zod";
+
+//#region ../action/dist/index.d.mts
+//#region src/action-definition.d.ts
+/** Runtime validation for an unbranded action definition. */
+declare const actionCoreSchema: z.ZodObject<{
+  slug: z.ZodString;
+  name: z.ZodString;
+  description: z.ZodString;
+  input: z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+  output: z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+  credentials: z.ZodOptional<z.ZodArray<z.ZodCustom<CredentialInput, CredentialInput>>>;
+  run: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+}, z.core.$strip>;
+type ActionMeta = Omit<z.infer<typeof actionCoreSchema>, "input" | "output" | "run" | "credentials"> & {
+  credentials?: CredentialList;
+};
+type ActionIO<TInputSchema extends z.ZodType, TOutputSchema extends z.ZodType, TCredentials> = {
+  input: TInputSchema;
+  output: TOutputSchema;
+  run(input: z.infer<TInputSchema>, credentials: TCredentials, ctx?: {
+    signal: AbortSignal;
+  }): Promise<z.infer<TOutputSchema>>;
+};
+declare const ACTION: unique symbol;
+/**
+ * Stored shape of an action after `defineAction`. Parametrized by inferred input/output
+ * types so consumers can write `ActionDefinition<unknown, unknown>`.
+ */
+type ActionDefinition<TInput = unknown, TOutput = unknown, TCredentials = Record<string, never>> = ActionMeta & ActionIO<z.ZodType<TInput>, z.ZodType<TOutput>, TCredentials> & {
+  readonly [ACTION]: true;
+};
+/**
+ * Authoring shape for `defineAction`. Parametrized by Zod *schemas* (not inferred types)
+ * so `run()` can infer its input and output from `input`/`output`.
+ */
+type ActionDefinitionInput<TInputSchema extends z.ZodType = z.ZodType, TOutputSchema extends z.ZodType = z.ZodType, TCredentials = Record<string, never>> = ActionMeta & ActionIO<TInputSchema, TOutputSchema, TCredentials> & {
+  credentials?: CredentialList;
+};
+/**
+ * Validates brand + shape via `actionCoreSchema` so discovery and guards reject
+ * malformed definitions.
+ */
+declare function isAction(value: unknown): value is ActionDefinition;
+declare function getActionCredentialRequirements(action: Pick<ActionDefinition<unknown, unknown, unknown>, "credentials">): CredentialList | undefined; //#endregion
+//#region src/step-invocation.d.ts
+type StepInvocationState = {
+  action: ActionDefinition<unknown, unknown, unknown>;
+  input: unknown | undefined;
+  scope?: CredentialScopeType; /** Build-injected structural call-site id (set by the compiled `.__site()` call). */
+  callSiteId?: string;
+};
+type StepInvocation<TOutput> = {
+  scope(scope: CredentialScopeType): StepInvocation<TOutput>;
+  run(input: unknown): StepInvocation<TOutput>;
+  /**
+   * Internal: stamps the build-injected structural call-site id onto the step so
+   * the runtime correlation id matches the canvas graph node. Emitted by the
+   * deploy build transform, never written by users.
+   */
+  __site(callSiteId: string): StepInvocation<TOutput>;
+  then<TResult1 = TOutput, TResult2 = never>(onfulfilled?: ((value: TOutput) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+};
+declare function isStepInvocation<TOutput>(value: unknown): value is StepInvocation<TOutput>;
+declare function createStepInvocation<TOutput>(state: StepInvocationState): StepInvocation<TOutput>; //#endregion
+//#region src/define-action.d.ts
+type WorkflowActionDefinition<TInput, TOutput, TCredentials = Record<string, never>, TRequirements extends CredentialList | undefined = undefined> = Omit<ActionDefinition<TInput, TOutput, TCredentials>, "run" | "credentials"> & {
+  credentials?: TRequirements;
+  run(input: TInput, credentials: TCredentials): Promise<TOutput>;
+  run(input: TInput): StepInvocation<TOutput>;
+  /**
+   * Pin this action's credential(s) to a single scope (e.g. `.scope("user")`). Returns a fresh
+   * action with the scope baked into its requirements, so it binds identically as a workflow step
+   * (`.scope("user").run(input)`) or an agent tool (`tools: [action.scope("user")]`). Without it,
+   * resolution is project default → org default.
+   */
+  scope(scope: CredentialScopeType): WorkflowActionDefinition<TInput, TOutput, TCredentials, TRequirements>;
+};
+declare function defineAction<TInputSchema extends z.ZodType, TOutputSchema extends z.ZodType>(def: ActionDefinitionInput<TInputSchema, TOutputSchema, Record<string, never>> & {
+  credentials?: never;
+}): WorkflowActionDefinition<z.infer<TInputSchema>, z.infer<TOutputSchema>, Record<string, never>, undefined>;
+declare function defineAction<TInputSchema extends z.ZodType, TOutputSchema extends z.ZodType, const TRequirements extends CredentialList>(def: ActionDefinitionInput<TInputSchema, TOutputSchema, ResolvedCredentials<TRequirements>> & {
+  credentials: TRequirements;
+}): WorkflowActionDefinition<z.infer<TInputSchema>, z.infer<TOutputSchema>, ResolvedCredentials<TRequirements>, TRequirements>; //#endregion
+//#region src/execute-action.d.ts
+declare function executeAction<TOutput>(action: Pick<ActionDefinition<unknown, unknown, unknown>, "input" | "output" | "run">, input: unknown, credentials?: unknown): Promise<TOutput>; //#endregion
+//#region src/mcp-credential-context-registry.d.ts
+/** Assignment target + tool consumer forwarded to platform MCP execute from worker runtimes. */
+type McpCredentialContext = {
+  assignmentTarget?: {
+    type: CredentialAssignmentTargetType;
+    key: string;
+  };
+  consumerId?: string;
+};
+declare function getRegisteredMcpCredentialContext(): McpCredentialContext | undefined;
+/**
+ * Run `fn` with MCP credential context active for its entire async execution. Nested calls merge
+ * over the enclosing context, so an agent's assignment target and a per-tool consumer id compose.
+ */
+declare function runWithMcpCredentialContext<T>(context: McpCredentialContext, fn: () => T | Promise<T>): T | Promise<T>; //#endregion
+//#region src/resolve-action-tool.d.ts
+type ResolveActionCredentialsFn = <T extends CredentialList>(requirements: T, consumer: CredentialConsumer, contextOverride?: Partial<Record<string, unknown>>) => Promise<ResolvedCredentials<T>>;
+type ResolveActionToolOptions = {
+  resolveCredentials?: ResolveActionCredentialsFn;
+  consumer?: CredentialConsumer;
+  contextOverride?: Partial<Record<string, unknown>>;
+  mcpCredentialContext?: McpCredentialContext;
+};
+declare function resolveActionTool(action: Pick<ActionDefinition<unknown, unknown, unknown>, "slug" | "name" | "description" | "input" | "output" | "run" | "credentials">, options?: ResolveActionToolOptions): AgentTool; //#endregion
+//#region src/action-execution-context.d.ts
+/**
+ * Runs an action's `run` body. Throws if another action is already executing in
+ * the current async context — that means an action called another action.
+ */
+declare function runWithinActionExecution<T>(actionKey: string, run: () => Promise<T>): Promise<T>;
+/**
+ * Resets the action-execution context for the duration of `fn`. Agent tool calls
+ * are fresh top-level executions even when the agent was prompted from inside an
+ * action, so calling actions as agent tools must not trip the guard.
+ */
+declare function runOutsideActionExecution<T>(fn: () => Promise<T>): Promise<T>;
+/** True while an action's `run` body is executing (agent steps are suppressed). */
+declare function isWithinActionExecution(): boolean; //#endregion
+//#region src/run-signal-context.d.ts
+/**
+ * Runs `fn` with `signal` as the ambient run-cancellation signal. The worker
+ * wires this once per queued run so every nested action/agent/workflow can read
+ * it via {@link getRunSignal} without threading a parameter — cancellation stays
+ * invisible to authoring SDKs.
+ */
+declare function runWithRunSignal<T>(signal: AbortSignal, fn: () => Promise<T>): Promise<T>;
+/** The current run's cancellation signal; never aborts outside a run. */
+declare function getRunSignal(): AbortSignal; //#endregion
+//#region src/workflow-run-registry.d.ts
+type AgentRunOptions = {
+  /** Build-injected structural call-site id (internal; lines runs up with the canvas). */callSiteId?: string;
+  runPrompt?: Record<string, unknown>;
+};
+type AgentPromptStepInput = {
+  message: string;
+  sessionId?: string;
+  agentId?: string;
+  files?: FilePart[];
+};
+type WorkflowRunHandle = {
+  actionRunner: (action: unknown, input: unknown, options?: {
+    callSiteId?: string;
+    credentialScope?: string;
+  }) => Promise<unknown>;
+  agentRunner?: (agent: unknown, input: AgentPromptStepInput, options?: AgentRunOptions) => Promise<unknown>;
+  llmRunner?: (opts: {
+    prompt: string;
+  } & Record<string, unknown>) => Promise<unknown>;
+  workflowRunner?: (workflow: unknown, input: unknown, options?: {
+    callSiteId?: string;
+  }) => Promise<unknown>;
+};
+declare function registerWorkflowRunGetter(fn: () => WorkflowRunHandle | undefined): void;
+declare function getWorkflowRunHandle(): WorkflowRunHandle | undefined; //#endregion
+//#region src/project-scope-registry.d.ts
+declare function registerProjectScopeGetter(fn: () => string | undefined): void;
+declare function getRegisteredProjectScopeId(): string | undefined; //#endregion
+//#endregion
+export { registerWorkflowRunGetter as C, runWithRunSignal as D, runWithMcpCredentialContext as E, runWithinActionExecution as O, registerProjectScopeGetter as S, runOutsideActionExecution as T, getRunSignal as _, ResolveActionCredentialsFn as a, isStepInvocation as b, WorkflowActionDefinition as c, createStepInvocation as d, defineAction as f, getRegisteredProjectScopeId as g, getRegisteredMcpCredentialContext as h, McpCredentialContext as i, WorkflowRunHandle as l, getActionCredentialRequirements as m, ActionDefinitionInput as n, ResolveActionToolOptions as o, executeAction as p, AgentRunOptions as r, StepInvocation as s, ActionDefinition as t, actionCoreSchema as u, getWorkflowRunHandle as v, resolveActionTool as w, isWithinActionExecution as x, isAction as y };
+//# sourceMappingURL=index-DO4QkV10.d.cts.map

package/dist/index-DO4QkV10.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DO4QkV10.d.cts","names":["z","AgentTool","CREDENTIAL_SCOPE_TYPES","Credential","CredentialAssignmentTargetType","CredentialAuthKind","CredentialConsumer","CredentialConsumer$1","CredentialInput","CredentialList","CredentialRequirement","CredentialScopeType","DefineCredentialInput","DefineOAuthCredentialInput","DefineStaticCredentialInput","FilePart","NormalizeCredential","ResolvedCredentials","credential","credentialInputSchema","defineCredential","isCredentialInput","normalizeCredentialList","toCredentialRequirement","actionCoreSchema","ZodString","core","$ZodTypeInternals","ZodType","ZodCustom","_$_keystrokehq_shared0","ZodArray","ZodOptional","$ZodFunctionArgs","$ZodFunctionOut","ZodFunction","$strip","ZodObject","slug","name","description","input","output","credentials","run","ActionMeta","infer","Omit","ActionIO","TInputSchema","TOutputSchema","TCredentials","AbortSignal","Promise","signal","ctx","ACTION","ActionDefinition","TInput","TOutput","Record","ActionDefinitionInput","isAction","value","getActionCredentialRequirements","Pick","action","StepInvocationState","scope","callSiteId","StepInvocation","TResult1","TResult2","PromiseLike","__site","then","onfulfilled","reason","onrejected","isStepInvocation","createStepInvocation","state","WorkflowActionDefinition","TRequirements","defineAction","def","executeAction","McpCredentialContext","assignmentTarget","type","key","consumerId","getRegisteredMcpCredentialContext","runWithMcpCredentialContext","T","context","fn","ResolveActionCredentialsFn","Partial","requirements","consumer","contextOverride","ResolveActionToolOptions","resolveCredentials","mcpCredentialContext","resolveActionTool","options","runWithinActionExecution","actionKey","runOutsideActionExecution","isWithinActionExecution","runWithRunSignal","getRunSignal","AgentRunOptions","runPrompt","AgentPromptStepInput","message","sessionId","agentId","files","WorkflowRunHandle","actionRunner","credentialScope","agentRunner","agent","llmRunner","prompt","opts","workflowRunner","workflow","registerWorkflowRunGetter","getWorkflowRunHandle","registerProjectScopeGetter","getRegisteredProjectScopeId"],"sources":["../../action/dist/index.d.mts"],"mappings":"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"}