@stackbone/sdk 0.1.0-alpha.7 → 0.1.0

package/index.d.cts

@@ -6,8 +6,8 @@ export { ChunkOptions, ChunkStrategy, DeleteOptions, DeleteResponse, IngestChunk
 import OpenAI from 'openai';
 import { ChatCompletionCreateParamsStreaming, ChatCompletionChunk, ChatCompletionCreateParamsNonStreaming, ChatCompletion, EmbeddingCreateParams, CreateEmbeddingResponse, ChatCompletionMessageParam } from 'openai/resources';
 import { Stream } from 'openai/streaming';
-import { A as AgentName } from './workflow-scheduler-DXCNKDOS.cjs';
-export { b as AgentRegistry, S as ScheduledWorkflow, c as WorkflowScheduler, a as WorkflowStartHandle, d as WorkflowStarter, W as WorkflowTriggerOptions, g as getWorkflowScheduler, e as getWorkflowStarter, s as setWorkflowScheduler, f as setWorkflowStarter } from './workflow-scheduler-DXCNKDOS.cjs';
+import { W as WorkflowName, c as StartWorkflowOptions, e as WorkflowStartHandle, b as StartWorkflowAndWaitOptions, S as ScheduledWorkflow, A as AgentName } from './agent-registry-BNXuj88Q.cjs';
+export { a as AgentRegistry, g as WorkflowScheduler, h as WorkflowStarter, i as WorkflowTriggerOptions, j as getWorkflowScheduler, k as getWorkflowStarter, l as setWorkflowScheduler, m as setWorkflowStarter } from './agent-registry-BNXuj88Q.cjs';
 import { a as ConnectionAccessor } from './call-connector-CYDw_yG5.cjs';
 import { S3Client } from '@aws-sdk/client-s3';
 import { z } from 'zod';
@@ -1198,6 +1198,37 @@ declare class SecretsFacade {
     private sql;
 }
 
+/**
+ * The shape of `stackbone.workflows` — the namespaced workflow trigger + schedule
+ * surface. Every `name` is typed `WorkflowName` (a loose `string` until
+ * `stackbone dev` generates `.stackbone/workflows.d.ts`, then the closed set of
+ * declared workflow names — a typo is a compile error).
+ */
+interface WorkflowsAccessor {
+    /**
+     * Start another workflow BY NAME as its own independent run, fire-and-forget;
+     * resolves to `{ runId }` immediately. Durable `"use step"`. MUST be called from
+     * inside a running workflow. See {@link startWorkflow}.
+     */
+    start(name: WorkflowName, input: unknown, opts?: StartWorkflowOptions): Promise<WorkflowStartHandle>;
+    /**
+     * Run another workflow BY NAME as a durable sub-routine: suspend until it
+     * reaches a terminal state, then return its output validated against the
+     * target's declared output schema. See {@link startWorkflowAndWait}.
+     */
+    startAndWait<TOutput = unknown>(name: WorkflowName, input: unknown, opts?: StartWorkflowAndWaitOptions): Promise<TOutput>;
+    /**
+     * Register (or upsert) a DYNAMIC recurring trigger that starts `name` on the
+     * `cron` cadence. Idempotent by `name`. Prefer the declarative `export const
+     * schedules` for cadences that ship with the workspace. See {@link scheduleWorkflow}.
+     */
+    schedule(name: WorkflowName, input: unknown, cron: string): Promise<void>;
+    /** Cancel a dynamic scheduled trigger by `name`. See {@link unschedule}. */
+    unschedule(name: WorkflowName): Promise<void>;
+    /** List active triggers (declarative + dynamic). See {@link listSchedules}. */
+    listSchedules(): Promise<ScheduledWorkflow[]>;
+}
+
 /**
  * eve's serialized session cursor. Mirrors eve's nominal `SessionState`
  * interface (`{ continuationToken?, sessionId?, streamIndex }`) so a value the
@@ -1897,6 +1928,22 @@ declare class StackboneClient {
      * signed workflow→agent call and the same eve `Client` API.
      */
     get agent(): AgentAccessor;
+    /**
+     * Namespaced workflow trigger + schedule surface — `stackbone.workflows.start(...)`
+     * / `.startAndWait(...)` / `.schedule(...)` / `.unschedule(...)` / `.listSchedules()`.
+     * Start another workflow by name (fire-and-forget or durable sub-routine) and
+     * manage dynamic cron triggers, all from inside a running workflow.
+     *
+     * These are peer-free shims over the ambient `WorkflowStarter` / `WorkflowScheduler`
+     * the runtime injects on first dispatch — they import NO `workflow` / `eve` peer,
+     * so (like `connection` / `agent`) they are wired directly onto the client and
+     * pull nothing new into the main barrel. This is the namespaced form of the loose
+     * `startWorkflow(...)` / `scheduleWorkflow(...)` exports (now `@deprecated`) on the
+     * `@stackbone/sdk/workflow` subpath; both delegate to the same implementation, so
+     * `start` / `startAndWait` keep their `"use step"` durability. The peer-bound
+     * authoring API (`requestApproval` / `defineHook` / `sleep`) stays on that subpath.
+     */
+    get workflows(): WorkflowsAccessor;
     /**
      * Pending surface — runtime not built. Every method returns
      * `not_implemented`. Mem0 is a third-party integration, not a Stackbone
@@ -2277,8 +2324,9 @@ declare function runWithCallerId<T>(id: string, fn: () => T, options?: {
  * `StackboneClient`: every property access (the surface accessors
  * `storage` / `rag` / `queues` / `database` / `secrets` / `config` / `ai` /
  * `approval` / `legacyConnections` / `memory` / `prompts` / `contract`, the
- * peer-free connector entrypoint `connection(id)`, plus the sibling-agent
- * entrypoint `agent(id)`) is forwarded to the singleton, which is created on the
+ * peer-free connector entrypoint `connection(id)`, the sibling-agent entrypoint
+ * `agent(id)`, plus the peer-free `workflows` trigger/schedule surface) is
+ * forwarded to the singleton, which is created on the
  * first such access. Because each `StackboneClient` accessor is itself lazy +
  * cached, repeated access returns the same surface instance (one client, one
  * pool, per process). `connection` and `agent` are plain function members (no
@@ -2502,4 +2550,4 @@ interface JsonSchemaDocument {
  */
 declare const analyzeAgentSchemas: (pair: AgentSchemaPair) => SchemaIntrospectionResult;
 
-export { type AddMemoryRequest, type AgentAccessor, type AgentSchemaPair, type AgentSpec, type AnyCapability, type ApprovalListOptions, type ApprovalListResult, type ApprovalRecord, type ApprovalRequest, type ApprovalRequestOptions, type ApprovalStatus, type ApprovalTool, type ApprovalToolSpec, type ApprovalTopic, type ApproverInfo, type ClientConfig, type CompilePromptResult, type ConfigRegistry, type ConsoleLike, type CreatePromptRequest, type Decision, type DecisionStatus, type DeleteAllMemoryRequest, type DeletePromptOptions, type DeletePromptResult, type EndSessionOptions, type EndSessionResult, type EveMessageResponse, type EveMessageResult, type EveSessionState, type EveStreamEvent, type FatalConstruct, type GeneratedImage, type GetPromptOptions, INVOCATION_ID_HEADER, INVOKE_TIMEOUT_HARD_CAP_MS, type ImageGenerateParams, type ImagesResponse, type IngestAsyncHandle, type InstallConsoleCaptureOptions, type InvocationContext, type InvokeCapability, type InvokeContext, type InvokeEnvelopeError, type InvokeErrorEnvelope, type InvokeOptions, type InvokeRequest, type InvokeResponse, type InvokeStream, type InvokeSuccessEnvelope, type JobCapability, type JsonSchemaDocument, type LazyAgentClient, type LazyAgentSession, type ListMemoryRequest, type ListMemoryResult, type ListOptions, type ListPromptsOptions, type ListPromptsResult, type LoadSystemSecretsArgs, type LogSink, type Logger, type LoggerBindings, type MemoryContent, type MemoryHistoryEntry, type MemoryHistoryEvent, type MemoryHit, type MemoryItem, type MemoryScope, type ModelsListResponse, type OpenRouterModel, type Prompt, type PublishRequest, RESERVED_ERROR_CODES, RESERVED_HANDLER_NAMES, RUN_ID_HEADER, type ReservedErrorCode, type Result, STORED_TO_SDK_ENV, type ScheduleRequest, type SchemaDiagnostic, type SchemaHalf, type SchemaIntrospectionResult, type SdkError, type SdkErrorCode, type SearchMemoryOptions, type SendTurnInput, type SignedUrl, type SignedUrlOptions, StackboneClient, type StackboneWorkspace, type StorageBody, type StorageObject, type StructuredLoggerOptions, type SystemSecretRow, type SystemSecretsReader, type UnscheduleRequest, type UpdateMemoryOptions, type UpdatePromptOptions, type UploadOptions, type VerifyOptions, type WarnConstruct, type WorkspaceAgent, type WorkspaceStandardSchema, type WorkspaceWorkflow, analyzeAgentSchemas, createClient, createStructuredLogger, defineAgent, defineWorkspace, getInvocationContext, installInvocationConsoleCapture, invokeRequestSchema, isReservedErrorCode, isSdkErrorCode, loadSystemSecretsIntoEnv, rehydrateSystemSecretsRows, runWithCallerId, runWithInvocationContext, stackbone };
+export { type AddMemoryRequest, type AgentAccessor, type AgentSchemaPair, type AgentSpec, type AnyCapability, type ApprovalListOptions, type ApprovalListResult, type ApprovalRecord, type ApprovalRequest, type ApprovalRequestOptions, type ApprovalStatus, type ApprovalTool, type ApprovalToolSpec, type ApprovalTopic, type ApproverInfo, type ClientConfig, type CompilePromptResult, type ConfigRegistry, type ConsoleLike, type CreatePromptRequest, type Decision, type DecisionStatus, type DeleteAllMemoryRequest, type DeletePromptOptions, type DeletePromptResult, type EndSessionOptions, type EndSessionResult, type EveMessageResponse, type EveMessageResult, type EveSessionState, type EveStreamEvent, type FatalConstruct, type GeneratedImage, type GetPromptOptions, INVOCATION_ID_HEADER, INVOKE_TIMEOUT_HARD_CAP_MS, type ImageGenerateParams, type ImagesResponse, type IngestAsyncHandle, type InstallConsoleCaptureOptions, type InvocationContext, type InvokeCapability, type InvokeContext, type InvokeEnvelopeError, type InvokeErrorEnvelope, type InvokeOptions, type InvokeRequest, type InvokeResponse, type InvokeStream, type InvokeSuccessEnvelope, type JobCapability, type JsonSchemaDocument, type LazyAgentClient, type LazyAgentSession, type ListMemoryRequest, type ListMemoryResult, type ListOptions, type ListPromptsOptions, type ListPromptsResult, type LoadSystemSecretsArgs, type LogSink, type Logger, type LoggerBindings, type MemoryContent, type MemoryHistoryEntry, type MemoryHistoryEvent, type MemoryHit, type MemoryItem, type MemoryScope, type ModelsListResponse, type OpenRouterModel, type Prompt, type PublishRequest, RESERVED_ERROR_CODES, RESERVED_HANDLER_NAMES, RUN_ID_HEADER, type ReservedErrorCode, type Result, STORED_TO_SDK_ENV, type ScheduleRequest, ScheduledWorkflow, type SchemaDiagnostic, type SchemaHalf, type SchemaIntrospectionResult, type SdkError, type SdkErrorCode, type SearchMemoryOptions, type SendTurnInput, type SignedUrl, type SignedUrlOptions, StackboneClient, type StackboneWorkspace, type StorageBody, type StorageObject, type StructuredLoggerOptions, type SystemSecretRow, type SystemSecretsReader, type UnscheduleRequest, type UpdateMemoryOptions, type UpdatePromptOptions, type UploadOptions, type VerifyOptions, type WarnConstruct, WorkflowStartHandle, type WorkflowsAccessor, type WorkspaceAgent, type WorkspaceStandardSchema, type WorkspaceWorkflow, analyzeAgentSchemas, createClient, createStructuredLogger, defineAgent, defineWorkspace, getInvocationContext, installInvocationConsoleCapture, invokeRequestSchema, isReservedErrorCode, isSdkErrorCode, loadSystemSecretsIntoEnv, rehydrateSystemSecretsRows, runWithCallerId, runWithInvocationContext, stackbone };

package/index.d.ts

@@ -6,8 +6,8 @@ export { ChunkOptions, ChunkStrategy, DeleteOptions, DeleteResponse, IngestChunk
 import OpenAI from 'openai';
 import { ChatCompletionCreateParamsStreaming, ChatCompletionChunk, ChatCompletionCreateParamsNonStreaming, ChatCompletion, EmbeddingCreateParams, CreateEmbeddingResponse, ChatCompletionMessageParam } from 'openai/resources';
 import { Stream } from 'openai/streaming';
-import { A as AgentName } from './workflow-scheduler-DXCNKDOS.js';
-export { b as AgentRegistry, S as ScheduledWorkflow, c as WorkflowScheduler, a as WorkflowStartHandle, d as WorkflowStarter, W as WorkflowTriggerOptions, g as getWorkflowScheduler, e as getWorkflowStarter, s as setWorkflowScheduler, f as setWorkflowStarter } from './workflow-scheduler-DXCNKDOS.js';
+import { W as WorkflowName, c as StartWorkflowOptions, e as WorkflowStartHandle, b as StartWorkflowAndWaitOptions, S as ScheduledWorkflow, A as AgentName } from './agent-registry-BNXuj88Q.js';
+export { a as AgentRegistry, g as WorkflowScheduler, h as WorkflowStarter, i as WorkflowTriggerOptions, j as getWorkflowScheduler, k as getWorkflowStarter, l as setWorkflowScheduler, m as setWorkflowStarter } from './agent-registry-BNXuj88Q.js';
 import { a as ConnectionAccessor } from './call-connector-CYDw_yG5.js';
 import { S3Client } from '@aws-sdk/client-s3';
 import { z } from 'zod';
@@ -1198,6 +1198,37 @@ declare class SecretsFacade {
     private sql;
 }
 
+/**
+ * The shape of `stackbone.workflows` — the namespaced workflow trigger + schedule
+ * surface. Every `name` is typed `WorkflowName` (a loose `string` until
+ * `stackbone dev` generates `.stackbone/workflows.d.ts`, then the closed set of
+ * declared workflow names — a typo is a compile error).
+ */
+interface WorkflowsAccessor {
+    /**
+     * Start another workflow BY NAME as its own independent run, fire-and-forget;
+     * resolves to `{ runId }` immediately. Durable `"use step"`. MUST be called from
+     * inside a running workflow. See {@link startWorkflow}.
+     */
+    start(name: WorkflowName, input: unknown, opts?: StartWorkflowOptions): Promise<WorkflowStartHandle>;
+    /**
+     * Run another workflow BY NAME as a durable sub-routine: suspend until it
+     * reaches a terminal state, then return its output validated against the
+     * target's declared output schema. See {@link startWorkflowAndWait}.
+     */
+    startAndWait<TOutput = unknown>(name: WorkflowName, input: unknown, opts?: StartWorkflowAndWaitOptions): Promise<TOutput>;
+    /**
+     * Register (or upsert) a DYNAMIC recurring trigger that starts `name` on the
+     * `cron` cadence. Idempotent by `name`. Prefer the declarative `export const
+     * schedules` for cadences that ship with the workspace. See {@link scheduleWorkflow}.
+     */
+    schedule(name: WorkflowName, input: unknown, cron: string): Promise<void>;
+    /** Cancel a dynamic scheduled trigger by `name`. See {@link unschedule}. */
+    unschedule(name: WorkflowName): Promise<void>;
+    /** List active triggers (declarative + dynamic). See {@link listSchedules}. */
+    listSchedules(): Promise<ScheduledWorkflow[]>;
+}
+
 /**
  * eve's serialized session cursor. Mirrors eve's nominal `SessionState`
  * interface (`{ continuationToken?, sessionId?, streamIndex }`) so a value the
@@ -1897,6 +1928,22 @@ declare class StackboneClient {
      * signed workflow→agent call and the same eve `Client` API.
      */
     get agent(): AgentAccessor;
+    /**
+     * Namespaced workflow trigger + schedule surface — `stackbone.workflows.start(...)`
+     * / `.startAndWait(...)` / `.schedule(...)` / `.unschedule(...)` / `.listSchedules()`.
+     * Start another workflow by name (fire-and-forget or durable sub-routine) and
+     * manage dynamic cron triggers, all from inside a running workflow.
+     *
+     * These are peer-free shims over the ambient `WorkflowStarter` / `WorkflowScheduler`
+     * the runtime injects on first dispatch — they import NO `workflow` / `eve` peer,
+     * so (like `connection` / `agent`) they are wired directly onto the client and
+     * pull nothing new into the main barrel. This is the namespaced form of the loose
+     * `startWorkflow(...)` / `scheduleWorkflow(...)` exports (now `@deprecated`) on the
+     * `@stackbone/sdk/workflow` subpath; both delegate to the same implementation, so
+     * `start` / `startAndWait` keep their `"use step"` durability. The peer-bound
+     * authoring API (`requestApproval` / `defineHook` / `sleep`) stays on that subpath.
+     */
+    get workflows(): WorkflowsAccessor;
     /**
      * Pending surface — runtime not built. Every method returns
      * `not_implemented`. Mem0 is a third-party integration, not a Stackbone
@@ -2277,8 +2324,9 @@ declare function runWithCallerId<T>(id: string, fn: () => T, options?: {
  * `StackboneClient`: every property access (the surface accessors
  * `storage` / `rag` / `queues` / `database` / `secrets` / `config` / `ai` /
  * `approval` / `legacyConnections` / `memory` / `prompts` / `contract`, the
- * peer-free connector entrypoint `connection(id)`, plus the sibling-agent
- * entrypoint `agent(id)`) is forwarded to the singleton, which is created on the
+ * peer-free connector entrypoint `connection(id)`, the sibling-agent entrypoint
+ * `agent(id)`, plus the peer-free `workflows` trigger/schedule surface) is
+ * forwarded to the singleton, which is created on the
  * first such access. Because each `StackboneClient` accessor is itself lazy +
  * cached, repeated access returns the same surface instance (one client, one
  * pool, per process). `connection` and `agent` are plain function members (no
@@ -2502,4 +2550,4 @@ interface JsonSchemaDocument {
  */
 declare const analyzeAgentSchemas: (pair: AgentSchemaPair) => SchemaIntrospectionResult;
 
-export { type AddMemoryRequest, type AgentAccessor, type AgentSchemaPair, type AgentSpec, type AnyCapability, type ApprovalListOptions, type ApprovalListResult, type ApprovalRecord, type ApprovalRequest, type ApprovalRequestOptions, type ApprovalStatus, type ApprovalTool, type ApprovalToolSpec, type ApprovalTopic, type ApproverInfo, type ClientConfig, type CompilePromptResult, type ConfigRegistry, type ConsoleLike, type CreatePromptRequest, type Decision, type DecisionStatus, type DeleteAllMemoryRequest, type DeletePromptOptions, type DeletePromptResult, type EndSessionOptions, type EndSessionResult, type EveMessageResponse, type EveMessageResult, type EveSessionState, type EveStreamEvent, type FatalConstruct, type GeneratedImage, type GetPromptOptions, INVOCATION_ID_HEADER, INVOKE_TIMEOUT_HARD_CAP_MS, type ImageGenerateParams, type ImagesResponse, type IngestAsyncHandle, type InstallConsoleCaptureOptions, type InvocationContext, type InvokeCapability, type InvokeContext, type InvokeEnvelopeError, type InvokeErrorEnvelope, type InvokeOptions, type InvokeRequest, type InvokeResponse, type InvokeStream, type InvokeSuccessEnvelope, type JobCapability, type JsonSchemaDocument, type LazyAgentClient, type LazyAgentSession, type ListMemoryRequest, type ListMemoryResult, type ListOptions, type ListPromptsOptions, type ListPromptsResult, type LoadSystemSecretsArgs, type LogSink, type Logger, type LoggerBindings, type MemoryContent, type MemoryHistoryEntry, type MemoryHistoryEvent, type MemoryHit, type MemoryItem, type MemoryScope, type ModelsListResponse, type OpenRouterModel, type Prompt, type PublishRequest, RESERVED_ERROR_CODES, RESERVED_HANDLER_NAMES, RUN_ID_HEADER, type ReservedErrorCode, type Result, STORED_TO_SDK_ENV, type ScheduleRequest, type SchemaDiagnostic, type SchemaHalf, type SchemaIntrospectionResult, type SdkError, type SdkErrorCode, type SearchMemoryOptions, type SendTurnInput, type SignedUrl, type SignedUrlOptions, StackboneClient, type StackboneWorkspace, type StorageBody, type StorageObject, type StructuredLoggerOptions, type SystemSecretRow, type SystemSecretsReader, type UnscheduleRequest, type UpdateMemoryOptions, type UpdatePromptOptions, type UploadOptions, type VerifyOptions, type WarnConstruct, type WorkspaceAgent, type WorkspaceStandardSchema, type WorkspaceWorkflow, analyzeAgentSchemas, createClient, createStructuredLogger, defineAgent, defineWorkspace, getInvocationContext, installInvocationConsoleCapture, invokeRequestSchema, isReservedErrorCode, isSdkErrorCode, loadSystemSecretsIntoEnv, rehydrateSystemSecretsRows, runWithCallerId, runWithInvocationContext, stackbone };
+export { type AddMemoryRequest, type AgentAccessor, type AgentSchemaPair, type AgentSpec, type AnyCapability, type ApprovalListOptions, type ApprovalListResult, type ApprovalRecord, type ApprovalRequest, type ApprovalRequestOptions, type ApprovalStatus, type ApprovalTool, type ApprovalToolSpec, type ApprovalTopic, type ApproverInfo, type ClientConfig, type CompilePromptResult, type ConfigRegistry, type ConsoleLike, type CreatePromptRequest, type Decision, type DecisionStatus, type DeleteAllMemoryRequest, type DeletePromptOptions, type DeletePromptResult, type EndSessionOptions, type EndSessionResult, type EveMessageResponse, type EveMessageResult, type EveSessionState, type EveStreamEvent, type FatalConstruct, type GeneratedImage, type GetPromptOptions, INVOCATION_ID_HEADER, INVOKE_TIMEOUT_HARD_CAP_MS, type ImageGenerateParams, type ImagesResponse, type IngestAsyncHandle, type InstallConsoleCaptureOptions, type InvocationContext, type InvokeCapability, type InvokeContext, type InvokeEnvelopeError, type InvokeErrorEnvelope, type InvokeOptions, type InvokeRequest, type InvokeResponse, type InvokeStream, type InvokeSuccessEnvelope, type JobCapability, type JsonSchemaDocument, type LazyAgentClient, type LazyAgentSession, type ListMemoryRequest, type ListMemoryResult, type ListOptions, type ListPromptsOptions, type ListPromptsResult, type LoadSystemSecretsArgs, type LogSink, type Logger, type LoggerBindings, type MemoryContent, type MemoryHistoryEntry, type MemoryHistoryEvent, type MemoryHit, type MemoryItem, type MemoryScope, type ModelsListResponse, type OpenRouterModel, type Prompt, type PublishRequest, RESERVED_ERROR_CODES, RESERVED_HANDLER_NAMES, RUN_ID_HEADER, type ReservedErrorCode, type Result, STORED_TO_SDK_ENV, type ScheduleRequest, ScheduledWorkflow, type SchemaDiagnostic, type SchemaHalf, type SchemaIntrospectionResult, type SdkError, type SdkErrorCode, type SearchMemoryOptions, type SendTurnInput, type SignedUrl, type SignedUrlOptions, StackboneClient, type StackboneWorkspace, type StorageBody, type StorageObject, type StructuredLoggerOptions, type SystemSecretRow, type SystemSecretsReader, type UnscheduleRequest, type UpdateMemoryOptions, type UpdatePromptOptions, type UploadOptions, type VerifyOptions, type WarnConstruct, WorkflowStartHandle, type WorkflowsAccessor, type WorkspaceAgent, type WorkspaceStandardSchema, type WorkspaceWorkflow, analyzeAgentSchemas, createClient, createStructuredLogger, defineAgent, defineWorkspace, getInvocationContext, installInvocationConsoleCapture, invokeRequestSchema, isReservedErrorCode, isSdkErrorCode, loadSystemSecretsIntoEnv, rehydrateSystemSecretsRows, runWithCallerId, runWithInvocationContext, stackbone };

package/index.js

@@ -16010,6 +16010,71 @@ var SecretsFacade = class {
     }
   }
 };
+
+// src/runtime/workflow-scheduler.ts
+var current;
+function setWorkflowScheduler(scheduler) {
+  current = scheduler;
+}
+__name(setWorkflowScheduler, "setWorkflowScheduler");
+function getWorkflowScheduler() {
+  if (!current) {
+    throw new Error("No workflow scheduler is bound. `scheduleWorkflow` / `unschedule` / `listSchedules` can only be called inside a running workflow runtime \u2014 the runtime binds the scheduler on its first dispatch.");
+  }
+  return current;
+}
+__name(getWorkflowScheduler, "getWorkflowScheduler");
+
+// src/surfaces/agent-local/workflows/schedule-workflow.ts
+async function scheduleWorkflow(name, input, cron) {
+  return getWorkflowScheduler().schedule(name, input, cron);
+}
+__name(scheduleWorkflow, "scheduleWorkflow");
+async function unschedule(name) {
+  return getWorkflowScheduler().unschedule(name);
+}
+__name(unschedule, "unschedule");
+async function listSchedules() {
+  return getWorkflowScheduler().listSchedules();
+}
+__name(listSchedules, "listSchedules");
+
+// src/runtime/workflow-starter.ts
+var current2;
+function setWorkflowStarter(starter) {
+  current2 = starter;
+}
+__name(setWorkflowStarter, "setWorkflowStarter");
+function getWorkflowStarter() {
+  if (!current2) {
+    throw new Error("No workflow starter is bound. `startWorkflow` / `startWorkflowAndWait` can only be called from inside a running workflow \u2014 the runtime binds the starter on its first dispatch.");
+  }
+  return current2;
+}
+__name(getWorkflowStarter, "getWorkflowStarter");
+
+// src/surfaces/agent-local/workflows/start-workflow.ts
+async function startWorkflow(name, input, opts) {
+  "use step";
+  return getWorkflowStarter().start(name, input, opts);
+}
+__name(startWorkflow, "startWorkflow");
+
+// src/surfaces/agent-local/workflows/start-workflow-and-wait.ts
+async function startWorkflowAndWait(name, input, opts) {
+  "use step";
+  return await getWorkflowStarter().startAndWait(name, input, opts);
+}
+__name(startWorkflowAndWait, "startWorkflowAndWait");
+
+// src/surfaces/agent-local/workflows/workflows-accessor.ts
+var workflows = {
+  start: startWorkflow,
+  startAndWait: startWorkflowAndWait,
+  schedule: scheduleWorkflow,
+  unschedule,
+  listSchedules
+};
 function agentRegistry() {
   const raw = process.env["AGENT_URLS"];
   if (!raw) {
@@ -17139,6 +17204,24 @@ var StackboneClient = class {
     return agent;
   }
   /**
+  * Namespaced workflow trigger + schedule surface — `stackbone.workflows.start(...)`
+  * / `.startAndWait(...)` / `.schedule(...)` / `.unschedule(...)` / `.listSchedules()`.
+  * Start another workflow by name (fire-and-forget or durable sub-routine) and
+  * manage dynamic cron triggers, all from inside a running workflow.
+  *
+  * These are peer-free shims over the ambient `WorkflowStarter` / `WorkflowScheduler`
+  * the runtime injects on first dispatch — they import NO `workflow` / `eve` peer,
+  * so (like `connection` / `agent`) they are wired directly onto the client and
+  * pull nothing new into the main barrel. This is the namespaced form of the loose
+  * `startWorkflow(...)` / `scheduleWorkflow(...)` exports (now `@deprecated`) on the
+  * `@stackbone/sdk/workflow` subpath; both delegate to the same implementation, so
+  * `start` / `startAndWait` keep their `"use step"` durability. The peer-bound
+  * authoring API (`requestApproval` / `defineHook` / `sleep`) stays on that subpath.
+  */
+  get workflows() {
+    return workflows;
+  }
+  /**
   * Pending surface — runtime not built. Every method returns
   * `not_implemented`. Mem0 is a third-party integration, not a Stackbone
   * Agent Protocol capability, so this surface is intentionally not gated.
@@ -17542,34 +17625,6 @@ function runWithCallerId(id, fn, options) {
 }
 __name(runWithCallerId, "runWithCallerId");
 
-// src/runtime/workflow-starter.ts
-var current;
-function setWorkflowStarter(starter) {
-  current = starter;
-}
-__name(setWorkflowStarter, "setWorkflowStarter");
-function getWorkflowStarter() {
-  if (!current) {
-    throw new Error("No workflow starter is bound. `startWorkflow` / `startWorkflowAndWait` can only be called from inside a running workflow \u2014 the runtime binds the starter on its first dispatch.");
-  }
-  return current;
-}
-__name(getWorkflowStarter, "getWorkflowStarter");
-
-// src/runtime/workflow-scheduler.ts
-var current2;
-function setWorkflowScheduler(scheduler) {
-  current2 = scheduler;
-}
-__name(setWorkflowScheduler, "setWorkflowScheduler");
-function getWorkflowScheduler() {
-  if (!current2) {
-    throw new Error("No workflow scheduler is bound. `scheduleWorkflow` / `unschedule` / `listSchedules` can only be called inside a running workflow runtime \u2014 the runtime binds the scheduler on its first dispatch.");
-  }
-  return current2;
-}
-__name(getWorkflowScheduler, "getWorkflowScheduler");
-
 // src/runtime/ambient-client.ts
 var cached;
 function resolveAmbientClient() {