@scarn/sdk 0.0.0-stage → 0.0.0

package/dist/index.js

@@ -0,0 +1,293 @@
+// @bun
+import {
+  artifactKindSchema2,
+  ARTIFACT_SCHEMA_KEYWORD2,
+  artifactPlatforms2,
+  EMBEDDABLE_ARTIFACT_EXTENSIONS2,
+  isEmbeddableArtifactExtension2,
+  artifactFileExtension2,
+  artifactAcceptsFile2,
+  readArtifactKeyword2,
+  matchArtifactNode2,
+  findArtifactFields2
+} from "./chunk-56e4kp0a.js";
+import {
+  ARTIFACT_MARKER_SCHEME2,
+  parseArtifactMarkerRef2,
+  formatArtifactMarkerRef2,
+  buildArtifactMarker2,
+  findArtifactMarkers2
+} from "./chunk-631ffb6r.js";
+import {
+  Api2,
+  Projects2,
+  StepDefinitions2,
+  Tasks2,
+  TaskRuns2,
+  PipelineDefinitions2,
+  PipelineExecutions2,
+  WorkItems2,
+  Conversations2,
+  WorkItemComments2,
+  WorkItemCommentDrafts2,
+  WorkItemBlocks2,
+  ProjectArtifacts2,
+  UserNotifications2,
+  NotificationRules2,
+  StepDefinitionTemplates2,
+  ProjectIntegrations2,
+  GitHubIntegrations2,
+  ProjectInvites2,
+  Billing2,
+  Username2,
+  Secrets2,
+  ScarnClient2
+} from "./chunk-ynk2bjae.js";
+import {
+  createTaskPlaneClient2,
+  createScarnClient2
+} from "./chunk-tfm5hjzm.js";
+import"./chunk-zpqyjgb4.js";
+import"./chunk-9s07v9r1.js";
+import"./chunk-s0gap8r8.js";
+import"./chunk-p6kc9wq8.js";
+import {
+  ARTIFACT_BRAND2,
+  ArtifactTypes2,
+  normalizeArtifactAccept2,
+  artifact2,
+  Artifact2,
+  exports_z,
+  createPromptInputProxy2,
+  createPromptTemplateContext2,
+  renderPromptTemplate2,
+  isSecretLookingEnvName2,
+  Env2,
+  normalizeEnv2,
+  Repo2,
+  compileRepo2,
+  Runtime2,
+  compileEnvironment2,
+  isMcpHandle2,
+  defineMcp2,
+  resolveMcpChecks2,
+  compileMcps2,
+  compileStepErrors2,
+  compileStepRetry2,
+  toStepHandle2,
+  toStepSpec2,
+  defineStep2,
+  codeStep2,
+  createStepDefinitionsClient2,
+  Features2,
+  Notify2
+} from "./chunk-91p9vzcs.js";
+import"./chunk-b21233rt.js";
+import {
+  openCodeMcpTimeoutSchema2,
+  openCodeMcpProtocolSchema2,
+  openCodeMcpLocalConfigSchema2,
+  openCodeMcpOAuthConfigSchema2,
+  openCodeMcpRemoteConfigSchema2,
+  openCodeMcpRefConfigSchema2,
+  openCodeResolvedMcpServerConfigSchema2,
+  openCodeResolvedMcpServersSchema2,
+  openCodeMcpServerConfigSchema2,
+  openCodeMcpServersSchema2,
+  isEnvPlaceholderValue2,
+  collectEnvPlaceholderNames2
+} from "./chunk-g0rdnn0r.js";
+import {
+  formatIssue2,
+  PipelineBuildError2
+} from "./chunk-eg1hcvhb.js";
+import {
+  PipelineDefinitionsApiError2,
+  createPipelineDefinitionsClient2,
+  WORK_ITEM_TOP_LEVEL_FIELDS2,
+  WORK_ITEM_FIELDS_PATH_PREFIX2,
+  resolveWorkItemFieldPath2,
+  DEFAULT_PIPELINE_ASSIGNMENT_FILENAME2,
+  defaultPipelineAssignment2,
+  serializeDefaultPipelineAssignment2,
+  isDefaultPipelineAssignmentSpec2
+} from "./chunk-qpw5wt1p.js";
+import {
+  definePipeline2,
+  decision2,
+  reply2,
+  succeed2,
+  fail2,
+  stepRef2,
+  workItem2,
+  workItemField2,
+  each2,
+  equal2,
+  notEqual2,
+  lessThan2,
+  lessThanInclusive2,
+  greaterThan2,
+  greaterThanInclusive2,
+  exists2,
+  isEmpty2,
+  contains2,
+  startsWith2,
+  endsWith2,
+  matches2,
+  before2,
+  after2,
+  all2,
+  any2,
+  not2,
+  some2,
+  every2,
+  none2,
+  sum2,
+  avg2,
+  min2,
+  max2,
+  count2
+} from "./chunk-rq3q8vg7.js";
+import"./chunk-4vehh3dq.js";
+import {
+  stripJsoncComments2,
+  stripTrailingCommas2,
+  parseJsonc2
+} from "./chunk-h9yxx0hd.js";
+import {
+  SCARN_CONFIG_RELATIVE_PATH2,
+  parseScarnConfig2
+} from "./chunk-4361gxk0.js";
+export {
+  ARTIFACT_BRAND2 as ARTIFACT_BRAND,
+  ARTIFACT_MARKER_SCHEME2 as ARTIFACT_MARKER_SCHEME,
+  ARTIFACT_SCHEMA_KEYWORD2 as ARTIFACT_SCHEMA_KEYWORD,
+  Api2 as Api,
+  Artifact2 as Artifact,
+  ArtifactTypes2 as ArtifactTypes,
+  Billing2 as Billing,
+  Conversations2 as Conversations,
+  DEFAULT_PIPELINE_ASSIGNMENT_FILENAME2 as DEFAULT_PIPELINE_ASSIGNMENT_FILENAME,
+  EMBEDDABLE_ARTIFACT_EXTENSIONS2 as EMBEDDABLE_ARTIFACT_EXTENSIONS,
+  Env2 as Env,
+  Features2 as Features,
+  GitHubIntegrations2 as GitHubIntegrations,
+  NotificationRules2 as NotificationRules,
+  Notify2 as Notify,
+  PipelineBuildError2 as PipelineBuildError,
+  PipelineDefinitions2 as PipelineDefinitions,
+  PipelineDefinitionsApiError2 as PipelineDefinitionsApiError,
+  PipelineExecutions2 as PipelineExecutions,
+  ProjectArtifacts2 as ProjectArtifacts,
+  ProjectIntegrations2 as ProjectIntegrations,
+  ProjectInvites2 as ProjectInvites,
+  Projects2 as Projects,
+  Repo2 as Repo,
+  Runtime2 as Runtime,
+  SCARN_CONFIG_RELATIVE_PATH2 as SCARN_CONFIG_RELATIVE_PATH,
+  ScarnClient2 as ScarnClient,
+  Secrets2 as Secrets,
+  StepDefinitionTemplates2 as StepDefinitionTemplates,
+  StepDefinitions2 as StepDefinitions,
+  TaskRuns2 as TaskRuns,
+  Tasks2 as Tasks,
+  UserNotifications2 as UserNotifications,
+  Username2 as Username,
+  WORK_ITEM_FIELDS_PATH_PREFIX2 as WORK_ITEM_FIELDS_PATH_PREFIX,
+  WORK_ITEM_TOP_LEVEL_FIELDS2 as WORK_ITEM_TOP_LEVEL_FIELDS,
+  WorkItemBlocks2 as WorkItemBlocks,
+  WorkItemCommentDrafts2 as WorkItemCommentDrafts,
+  WorkItemComments2 as WorkItemComments,
+  WorkItems2 as WorkItems,
+  after2 as after,
+  all2 as all,
+  any2 as any,
+  artifact2 as artifact,
+  artifactAcceptsFile2 as artifactAcceptsFile,
+  artifactFileExtension2 as artifactFileExtension,
+  artifactKindSchema2 as artifactKindSchema,
+  artifactPlatforms2 as artifactPlatforms,
+  avg2 as avg,
+  before2 as before,
+  buildArtifactMarker2 as buildArtifactMarker,
+  codeStep2 as codeStep,
+  collectEnvPlaceholderNames2 as collectEnvPlaceholderNames,
+  compileEnvironment2 as compileEnvironment,
+  compileMcps2 as compileMcps,
+  compileRepo2 as compileRepo,
+  compileStepErrors2 as compileStepErrors,
+  compileStepRetry2 as compileStepRetry,
+  contains2 as contains,
+  count2 as count,
+  createPipelineDefinitionsClient2 as createPipelineDefinitionsClient,
+  createPromptInputProxy2 as createPromptInputProxy,
+  createPromptTemplateContext2 as createPromptTemplateContext,
+  createScarnClient2 as createScarnClient,
+  createStepDefinitionsClient2 as createStepDefinitionsClient,
+  createTaskPlaneClient2 as createTaskPlaneClient,
+  decision2 as decision,
+  defaultPipelineAssignment2 as defaultPipelineAssignment,
+  defineMcp2 as defineMcp,
+  definePipeline2 as definePipeline,
+  defineStep2 as defineStep,
+  each2 as each,
+  endsWith2 as endsWith,
+  equal2 as equal,
+  every2 as every,
+  exists2 as exists,
+  fail2 as fail,
+  findArtifactFields2 as findArtifactFields,
+  findArtifactMarkers2 as findArtifactMarkers,
+  formatArtifactMarkerRef2 as formatArtifactMarkerRef,
+  formatIssue2 as formatIssue,
+  greaterThan2 as greaterThan,
+  greaterThanInclusive2 as greaterThanInclusive,
+  isDefaultPipelineAssignmentSpec2 as isDefaultPipelineAssignmentSpec,
+  isEmbeddableArtifactExtension2 as isEmbeddableArtifactExtension,
+  isEmpty2 as isEmpty,
+  isEnvPlaceholderValue2 as isEnvPlaceholderValue,
+  isMcpHandle2 as isMcpHandle,
+  isSecretLookingEnvName2 as isSecretLookingEnvName,
+  lessThan2 as lessThan,
+  lessThanInclusive2 as lessThanInclusive,
+  matchArtifactNode2 as matchArtifactNode,
+  matches2 as matches,
+  max2 as max,
+  min2 as min,
+  none2 as none,
+  normalizeArtifactAccept2 as normalizeArtifactAccept,
+  normalizeEnv2 as normalizeEnv,
+  not2 as not,
+  notEqual2 as notEqual,
+  openCodeMcpLocalConfigSchema2 as openCodeMcpLocalConfigSchema,
+  openCodeMcpOAuthConfigSchema2 as openCodeMcpOAuthConfigSchema,
+  openCodeMcpProtocolSchema2 as openCodeMcpProtocolSchema,
+  openCodeMcpRefConfigSchema2 as openCodeMcpRefConfigSchema,
+  openCodeMcpRemoteConfigSchema2 as openCodeMcpRemoteConfigSchema,
+  openCodeMcpServerConfigSchema2 as openCodeMcpServerConfigSchema,
+  openCodeMcpServersSchema2 as openCodeMcpServersSchema,
+  openCodeMcpTimeoutSchema2 as openCodeMcpTimeoutSchema,
+  openCodeResolvedMcpServerConfigSchema2 as openCodeResolvedMcpServerConfigSchema,
+  openCodeResolvedMcpServersSchema2 as openCodeResolvedMcpServersSchema,
+  parseArtifactMarkerRef2 as parseArtifactMarkerRef,
+  parseJsonc2 as parseJsonc,
+  parseScarnConfig2 as parseScarnConfig,
+  readArtifactKeyword2 as readArtifactKeyword,
+  renderPromptTemplate2 as renderPromptTemplate,
+  reply2 as reply,
+  resolveMcpChecks2 as resolveMcpChecks,
+  resolveWorkItemFieldPath2 as resolveWorkItemFieldPath,
+  serializeDefaultPipelineAssignment2 as serializeDefaultPipelineAssignment,
+  some2 as some,
+  startsWith2 as startsWith,
+  stepRef2 as stepRef,
+  stripJsoncComments2 as stripJsoncComments,
+  stripTrailingCommas2 as stripTrailingCommas,
+  succeed2 as succeed,
+  sum2 as sum,
+  toStepHandle2 as toStepHandle,
+  toStepSpec2 as toStepSpec,
+  workItem2 as workItem,
+  workItemField2 as workItemField,
+  exports_z as z
+};

package/dist/jsonc.d.ts

@@ -0,0 +1,3 @@
+export declare const stripJsoncComments: (content: string) => string;
+export declare const stripTrailingCommas: (content: string) => string;
+export declare const parseJsonc: (content: string) => unknown;

package/dist/jsonc.js

@@ -0,0 +1,11 @@
+// @bun
+import {
+  stripJsoncComments2,
+  stripTrailingCommas2,
+  parseJsonc2
+} from "./chunk-h9yxx0hd.js";
+export {
+  parseJsonc2 as parseJsonc,
+  stripJsoncComments2 as stripJsoncComments,
+  stripTrailingCommas2 as stripTrailingCommas
+};

package/dist/managed-runtimes.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+/**
+ * Registry of managed runtimes: worker-supplied containers a `codeStep` can run
+ * in instead of the project's devcontainer (`Runtime.managed.<id>()`). The
+ * identifier is the runtime family plus its major line. Image, distro and patch
+ * version are worker registry details and never appear here.
+ *
+ * This module is the single owner of the identifier list: the SDK, core and the
+ * worker all import from it. Adding an identifier is one entry here and one
+ * worker registry entry.
+ */
+export declare const MANAGED_RUNTIME_IDS: readonly ["bun1", "node24"];
+export type ManagedRuntimeId = (typeof MANAGED_RUNTIME_IDS)[number];
+/** The runtime a `codeStep` gets when it declares none. */
+export declare const DEFAULT_CODE_STEP_RUNTIME_ID = "bun1";
+export declare const managedRuntimeIdSchema: z.ZodEnum<{
+    bun1: "bun1";
+    node24: "node24";
+}>;
+export declare function isManagedRuntimeId(value: string): value is ManagedRuntimeId;

package/dist/managed-runtimes.js

@@ -0,0 +1,13 @@
+// @bun
+import {
+  MANAGED_RUNTIME_IDS2,
+  DEFAULT_CODE_STEP_RUNTIME_ID2,
+  managedRuntimeIdSchema2,
+  isManagedRuntimeId2
+} from "./chunk-s0gap8r8.js";
+export {
+  DEFAULT_CODE_STEP_RUNTIME_ID2 as DEFAULT_CODE_STEP_RUNTIME_ID,
+  MANAGED_RUNTIME_IDS2 as MANAGED_RUNTIME_IDS,
+  isManagedRuntimeId2 as isManagedRuntimeId,
+  managedRuntimeIdSchema2 as managedRuntimeIdSchema
+};

package/dist/opencode-mcp.d.ts

@@ -0,0 +1,313 @@
+/**
+ * Step-declared MCP servers, in OpenCode v2's native `mcp.servers.<name>` entry
+ * shape, plus a Scarn-only `ref` entry. The worker resolves refs before
+ * passing the resulting `local`/`remote` entries to the runtime overlay, so
+ * the `local`/`remote` schemas mirror the v2 config schema.
+ * `test/opencode-config-shapes.test.ts` fails typecheck if they drift from
+ * `@opencode/client`'s generated `ConfigEntry` type.
+ */
+import { z } from "zod";
+export declare const openCodeMcpTimeoutSchema: z.ZodObject<{
+    startup: z.ZodOptional<z.ZodInt>;
+    catalog: z.ZodOptional<z.ZodInt>;
+    execution: z.ZodOptional<z.ZodInt>;
+}, z.core.$strict>;
+export declare const openCodeMcpProtocolSchema: z.ZodEnum<{
+    auto: "auto";
+    legacy: "legacy";
+    "2026-07-28": "2026-07-28";
+}>;
+/** A `local` entry, exactly as OpenCode reads it. */
+export declare const openCodeMcpLocalConfigSchema: z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"local">;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export declare const openCodeMcpOAuthConfigSchema: z.ZodObject<{
+    client_id: z.ZodOptional<z.ZodString>;
+    client_secret: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+    callback_port: z.ZodOptional<z.ZodInt>;
+    redirect_uri: z.ZodOptional<z.ZodString>;
+    auth_server_metadata_url: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** A `remote` entry, exactly as OpenCode reads it. */
+export declare const openCodeMcpRemoteConfigSchema: z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"remote">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    oauth: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        client_id: z.ZodOptional<z.ZodString>;
+        client_secret: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        callback_port: z.ZodOptional<z.ZodInt>;
+        redirect_uri: z.ZodOptional<z.ZodString>;
+        auth_server_metadata_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodLiteral<false>]>>;
+}, z.core.$strict>;
+/**
+ * A reference to an MCP server defined in the repository's own MCP config
+ * files (`.opencode/opencode.json`, `.mcp.json`, `.codex/config.toml`, …).
+ * `name` defaults to the step's server key. The worker resolves refs into
+ * `local`/`remote` entries before launch, applying the shared fields on top;
+ * `name` is Scarn-only and dropped during resolution, so a ref never reaches
+ * OpenCode.
+ */
+export declare const openCodeMcpRefConfigSchema: z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"ref">;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const openCodeResolvedMcpServerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"local">;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"remote">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    oauth: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        client_id: z.ZodOptional<z.ZodString>;
+        client_secret: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        callback_port: z.ZodOptional<z.ZodInt>;
+        redirect_uri: z.ZodOptional<z.ZodString>;
+        auth_server_metadata_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodLiteral<false>]>>;
+}, z.core.$strict>], "type">;
+export declare const openCodeResolvedMcpServersSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"local">;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"remote">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    oauth: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        client_id: z.ZodOptional<z.ZodString>;
+        client_secret: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        callback_port: z.ZodOptional<z.ZodInt>;
+        redirect_uri: z.ZodOptional<z.ZodString>;
+        auth_server_metadata_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodLiteral<false>]>>;
+}, z.core.$strict>], "type">>;
+/** The authored/stored shape: `local`, `remote`, or an unresolved `ref`. */
+export declare const openCodeMcpServerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"local">;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"remote">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    oauth: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        client_id: z.ZodOptional<z.ZodString>;
+        client_secret: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        callback_port: z.ZodOptional<z.ZodInt>;
+        redirect_uri: z.ZodOptional<z.ZodString>;
+        auth_server_metadata_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodLiteral<false>]>>;
+}, z.core.$strict>, z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"ref">;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "type">;
+export declare const openCodeMcpServersSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"local">;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"remote">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    oauth: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        client_id: z.ZodOptional<z.ZodString>;
+        client_secret: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        callback_port: z.ZodOptional<z.ZodInt>;
+        redirect_uri: z.ZodOptional<z.ZodString>;
+        auth_server_metadata_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodLiteral<false>]>>;
+}, z.core.$strict>, z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    codemode: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodObject<{
+        startup: z.ZodOptional<z.ZodInt>;
+        catalog: z.ZodOptional<z.ZodInt>;
+        execution: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        legacy: "legacy";
+        "2026-07-28": "2026-07-28";
+    }>>;
+    type: z.ZodLiteral<"ref">;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "type">>;
+/**
+ * Whether `value` carries nothing but `{env:VAR}` placeholders, optionally
+ * behind an HTTP auth scheme (`Bearer {env:TOKEN}`). Anything else is a
+ * literal that would be stored in plaintext, so a `local` server's
+ * `environment` values and a `remote` server's `headers` values must pass it.
+ */
+export declare function isEnvPlaceholderValue(value: string): boolean;
+/** A JSON-like value that may hold `{env:VAR}` placeholders in its strings. */
+export type EnvPlaceholderSource = string | number | boolean | null | undefined | readonly EnvPlaceholderSource[] | {
+    readonly [key: string]: EnvPlaceholderSource;
+};
+/** Every variable name a value reads as `{env:VAR}`, at any depth, sorted. */
+export declare function collectEnvPlaceholderNames(value: EnvPlaceholderSource): string[];
+export type OpenCodeMcpRefConfig = z.infer<typeof openCodeMcpRefConfigSchema>;
+export type OpenCodeMcpServerConfig = z.infer<typeof openCodeMcpServerConfigSchema>;
+export type OpenCodeMcpServers = z.infer<typeof openCodeMcpServersSchema>;
+export type ResolvedOpenCodeMcpServerConfig = z.infer<typeof openCodeResolvedMcpServerConfigSchema>;
+export type ResolvedOpenCodeMcpServers = z.infer<typeof openCodeResolvedMcpServersSchema>;

package/dist/opencode-mcp.js

@@ -0,0 +1,29 @@
+// @bun
+import {
+  openCodeMcpTimeoutSchema2,
+  openCodeMcpProtocolSchema2,
+  openCodeMcpLocalConfigSchema2,
+  openCodeMcpOAuthConfigSchema2,
+  openCodeMcpRemoteConfigSchema2,
+  openCodeMcpRefConfigSchema2,
+  openCodeResolvedMcpServerConfigSchema2,
+  openCodeResolvedMcpServersSchema2,
+  openCodeMcpServerConfigSchema2,
+  openCodeMcpServersSchema2,
+  isEnvPlaceholderValue2,
+  collectEnvPlaceholderNames2
+} from "./chunk-g0rdnn0r.js";
+export {
+  collectEnvPlaceholderNames2 as collectEnvPlaceholderNames,
+  isEnvPlaceholderValue2 as isEnvPlaceholderValue,
+  openCodeMcpLocalConfigSchema2 as openCodeMcpLocalConfigSchema,
+  openCodeMcpOAuthConfigSchema2 as openCodeMcpOAuthConfigSchema,
+  openCodeMcpProtocolSchema2 as openCodeMcpProtocolSchema,
+  openCodeMcpRefConfigSchema2 as openCodeMcpRefConfigSchema,
+  openCodeMcpRemoteConfigSchema2 as openCodeMcpRemoteConfigSchema,
+  openCodeMcpServerConfigSchema2 as openCodeMcpServerConfigSchema,
+  openCodeMcpServersSchema2 as openCodeMcpServersSchema,
+  openCodeMcpTimeoutSchema2 as openCodeMcpTimeoutSchema,
+  openCodeResolvedMcpServerConfigSchema2 as openCodeResolvedMcpServerConfigSchema,
+  openCodeResolvedMcpServersSchema2 as openCodeResolvedMcpServersSchema
+};

package/dist/pipelines/chain.d.ts

@@ -0,0 +1,7 @@
+import { type NodeDef } from "./model";
+/**
+ * Puts the chain-starting methods on a handle as non-enumerable properties,
+ * so the handle's spec fields (and `toStepSpec`) are unchanged. Each call
+ * starts a fresh chain.
+ */
+export declare function attachChainMethods(handle: object, node: NodeDef): void;