@lastshotlabs/slingshot-orchestration
npm install @lastshotlabs/slingshot-orchestration
Functions
Section titled “Functions”createOrchestrationPackage
Section titled “createOrchestrationPackage”Retry adapter.start() with exponential backoff.
function createOrchestrationPackage(options: ConfigurableOrchestrationPluginOptions,): SlingshotPackageDefinitionSource: packages/slingshot-orchestration/src/plugin.ts
createSlingshotEventSink
Section titled “createSlingshotEventSink”Disposable orchestration event sink that bridges the orchestration runtime onto
Slingshot’s event bus. The plugin teardown phase MUST call dispose() so any
subscriptions registered against the bus by this sink (or future helpers
sharing this contract) do not accumulate across plugin reloads.
function createSlingshotEventSink(bus: SlingshotEventBus): SlingshotEventSinkSource: packages/slingshot-orchestration/src/eventSink.ts
getOrchestration
Section titled “getOrchestration”Plugin name used for registration, dependency declarations, and event ownership.
function getOrchestration(ctx: SlingshotContext): OrchestrationRuntimeSource: packages/slingshot-orchestration/src/context.ts
getOrchestrationOrNull
Section titled “getOrchestrationOrNull”Plugin name used for registration, dependency declarations, and event ownership.
function getOrchestrationOrNull(ctx: SlingshotContext): OrchestrationRuntime | nullSource: packages/slingshot-orchestration/src/context.ts
orchestrationPluginConfigSchema
Section titled “orchestrationPluginConfigSchema”Manifest schema for the Slingshot orchestration plugin configuration.
Config Fields
Section titled “Config Fields”| Field | Description |
|---|---|
adapter | Adapter selection and its backend-specific configuration. |
routePrefix | URL prefix for orchestration routes (e.g. ‘/orchestration’). |
routes | Mount the orchestration HTTP API routes. Defaults to false. |
routeTimeoutMs | Per-request timeout in milliseconds for orchestration HTTP route adapter calls. |
tasks | Handler names of tasks to register with the orchestration runtime. |
workflows | Handler names of workflows to register. Omit when only tasks are used. |
Source: packages/slingshot-orchestration/src/validation.ts
Constants
Section titled “Constants”Orchestration
Section titled “Orchestration”Public contract for slingshot-orchestration.
Cross-plugin consumers fetch the orchestration runtime through the typed
OrchestrationRuntimeCap capability:
import { OrchestrationRuntimeCap } from '@lastshotlabs/slingshot-orchestration';const runtime = ctx.capabilities.require(OrchestrationRuntimeCap);The legacy getOrchestration(ctx) / getOrchestrationOrNull(ctx) helpers remain as
thin wrappers around the contract resolution path for back-compat with documented
examples.
Source: packages/slingshot-orchestration/src/public.ts
ORCHESTRATION_PLUGIN_STATE_KEY
Section titled “ORCHESTRATION_PLUGIN_STATE_KEY”Plugin name used for registration, dependency declarations, and event ownership.
Source: packages/slingshot-orchestration/src/context.ts
OrchestrationRuntimeCap
Section titled “OrchestrationRuntimeCap”Public contract for slingshot-orchestration.
Cross-plugin consumers fetch the orchestration runtime through the typed
OrchestrationRuntimeCap capability:
import { OrchestrationRuntimeCap } from '@lastshotlabs/slingshot-orchestration';const runtime = ctx.capabilities.require(OrchestrationRuntimeCap);The legacy getOrchestration(ctx) / getOrchestrationOrNull(ctx) helpers remain as
thin wrappers around the contract resolution path for back-compat with documented
examples.
Source: packages/slingshot-orchestration/src/public.ts
Classes
Section titled “Classes”InvalidResolverResultError
Section titled “InvalidResolverResultError”Errors thrown by the orchestration plugin integration layer.
Source: packages/slingshot-orchestration/src/errors.ts
Interfaces
Section titled “Interfaces”OrchestrationRequestContext
Section titled “OrchestrationRequestContext”Request-scoped orchestration metadata resolved by the HTTP layer before a run is started or authorized.
Source: packages/slingshot-orchestration/src/types.ts
OrchestrationRunAuthorizationInput
Section titled “OrchestrationRunAuthorizationInput”Request-scoped orchestration metadata resolved by the HTTP layer before a run is started or authorized.
Source: packages/slingshot-orchestration/src/types.ts
ConfigurableOrchestrationPluginOptions
Section titled “ConfigurableOrchestrationPluginOptions”Request-scoped orchestration metadata resolved by the HTTP layer before a run is started or authorized.
Source: packages/slingshot-orchestration/src/types.ts
OrchestrationPluginConfig
Section titled “OrchestrationPluginConfig”Request-scoped orchestration metadata resolved by the HTTP layer before a run is started or authorized.
Source: packages/slingshot-orchestration/src/types.ts
OrchestrationPluginOptions
Section titled “OrchestrationPluginOptions”Request-scoped orchestration metadata resolved by the HTTP layer before a run is started or authorized.
Source: packages/slingshot-orchestration/src/types.ts
OrchestrationRequestContextResolver
Section titled “OrchestrationRequestContextResolver”Request-scoped orchestration metadata resolved by the HTTP layer before a run is started or authorized.
Source: packages/slingshot-orchestration/src/types.ts
OrchestrationRunAuthorizer
Section titled “OrchestrationRunAuthorizer”Request-scoped orchestration metadata resolved by the HTTP layer before a run is started or authorized.
Source: packages/slingshot-orchestration/src/types.ts
ResolvedOrchestrationPluginOptions
Section titled “ResolvedOrchestrationPluginOptions”Request-scoped orchestration metadata resolved by the HTTP layer before a run is started or authorized.
Source: packages/slingshot-orchestration/src/types.ts