@boboddy/sdk 0.2.12-alpha → 0.2.13-alpha

package/dist/boboddy-config-parser.d.ts

@@ -15,11 +15,6 @@ export type BoboddyServiceDefinition = {
         targetPort: number;
         protocol: string;
     };
-    healthcheck: {
-        protocol: string;
-        path: string | null;
-        expectedStatus: number | null;
-    };
 };
 export type BoboddyConfig = {
     commands: BoboddyCommandDefinition[];

package/dist/boboddy-config-parser.js

@@ -147,7 +147,6 @@ var parseServices = (raw) => {
     return [];
   return Object.entries(raw).map(([name, entry]) => {
     const expose = entry.expose ?? {};
-    const healthcheck = entry.healthcheck ?? {};
     const dependsOn = Array.isArray(entry.dependsOn) ? entry.dependsOn.filter((d) => typeof d === "string") : [];
     return {
       name,
@@ -158,11 +157,6 @@ var parseServices = (raw) => {
       expose: {
         targetPort: asNumber(expose.targetPort) ?? 0,
         protocol: asString(expose.protocol) ?? "http"
-      },
-      healthcheck: {
-        protocol: asString(healthcheck.protocol) ?? "http",
-        path: asString(healthcheck.path) ?? null,
-        expectedStatus: asNumber(healthcheck.expectedStatus) ?? null
       }
     };
   });

package/dist/definitions/steps/define-step.d.ts

@@ -29,6 +29,25 @@ type OpenCodeMcpServers = Record<string, {
 type OpenCodePluginEntry = string | [string, Record<string, unknown>];
 /** Full value of the OpenCode `plugin` config field. */
 type OpenCodePlugins = OpenCodePluginEntry[];
+type HealthCheckSeverity = "required" | "warn";
+/**
+ * A single step-declared health check: a real tool call made against the
+ * launched environment before the agent starts working.
+ *
+ * `tool` is a bare name when `mcp` is set (resolved at runtime to
+ * `${mcp}_${tool}`); otherwise it is a flat tool id. `mcp`, when present,
+ * must name a server declared in this step's `mcpServers`.
+ */
+type HealthCheck = {
+    tool: string;
+    mcp?: string;
+    name?: string;
+    args?: Record<string, unknown>;
+    severity?: HealthCheckSeverity;
+    timeoutMs?: number;
+};
+/** Full value of a step's `healthChecks` field. */
+type HealthChecks = HealthCheck[];
 type SignalTypeStr = "string" | "number" | "boolean" | "object" | "array";
 export type DotPaths<T, D extends readonly unknown[] = []> = D["length"] extends 4 ? string : unknown extends T ? string : T extends readonly unknown[] ? string : T extends object ? {
     [K in keyof T & string]: K | (NonNullable<T[K]> extends object ? `${K}.${DotPaths<NonNullable<T[K]>, [...D, unknown]> & string}` : never);
@@ -63,6 +82,7 @@ export type DefineStepInput<TInput extends ZodType = ZodType, TResult extends Zo
     features?: AnyStepFeature[];
     mcpServers?: OpenCodeMcpServers | null;
     plugins?: OpenCodePlugins | null;
+    healthChecks?: HealthChecks | null;
     status?: "draft" | "active";
     executionMode?: "workspace" | "no_workspace";
 };
@@ -94,6 +114,7 @@ export type StepDefinitionSpec = {
     }>;
     opencodeMcpJson: OpenCodeMcpServers | null;
     opencodePluginJson: OpenCodePlugins | null;
+    healthChecksJson: HealthChecks | null;
 };
 export type SignalTypeStrToTs<T extends SignalTypeStr> = T extends "string" ? string : T extends "number" ? number : T extends "boolean" ? boolean : T extends "array" ? unknown[] : T extends "object" ? object : unknown;
 export type SignalTypeMapOf<TSignals extends readonly unknown[], TResult> = {

package/dist/definitions/steps/index.js

@@ -12075,7 +12075,8 @@ ${feature._promptAddition}` : feature._promptAddition;
       }))
     ],
     opencodeMcpJson: config2.mcpServers ?? null,
-    opencodePluginJson: config2.plugins ?? null
+    opencodePluginJson: config2.plugins ?? null,
+    healthChecksJson: config2.healthChecks ?? null
   };
   return spec;
 }

package/dist/definitions/steps/step-definitions-client.d.ts

@@ -48,6 +48,16 @@ declare const buildStepDefinitionsClient: (stepDefinitions: StepDefinitions) =>
             };
         } | unknown;
         opencodePluginJson: Array<string | Array<unknown>> | unknown;
+        healthChecksJson: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: "required" | "warn";
+            timeoutMs: number;
+        }> | unknown;
         status: "draft" | "active" | "archived";
         signalExtractorDefinitions: Array<{
             id: string;
@@ -102,6 +112,16 @@ declare const buildStepDefinitionsClient: (stepDefinitions: StepDefinitions) =>
             };
         } | unknown;
         opencodePluginJson: Array<string | Array<unknown>> | unknown;
+        healthChecksJson: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: "required" | "warn";
+            timeoutMs: number;
+        }> | unknown;
         status: "draft" | "active" | "archived";
         signalExtractorDefinitions: Array<{
             id: string;
@@ -161,6 +181,16 @@ declare const buildStepDefinitionsClient: (stepDefinitions: StepDefinitions) =>
             };
         } | unknown;
         opencodePluginJson: Array<string | Array<unknown>> | unknown;
+        healthChecksJson: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: "required" | "warn";
+            timeoutMs: number;
+        }> | unknown;
         status: "draft" | "active" | "archived";
         signalExtractorDefinitions: Array<{
             id: string;

package/dist/definitions/validation/index.js

@@ -269,6 +269,36 @@ function checkSignalSourcePaths(steps) {
   }
   return issues;
 }
+function checkHealthChecks(steps) {
+  const issues = [];
+  for (const step of steps) {
+    const checks = step.healthChecksJson ?? [];
+    if (checks.length === 0)
+      continue;
+    const mcpServerKeys = Object.keys(step.opencodeMcpJson ?? {});
+    const mcpServerKeySet = new Set(mcpServerKeys);
+    checks.forEach((check, index) => {
+      const label = check.name ?? check.tool;
+      const where = `Step "${step.key}" health check #${String(index + 1)} ("${label}")`;
+      if (!check.mcp)
+        return;
+      if (!mcpServerKeySet.has(check.mcp)) {
+        issues.push({
+          check: "health-check-mcp-server",
+          message: `${where} names MCP server "${check.mcp}", but the step declares no ` + `such server in mcpServers. Declared servers: ${mcpServerKeys.length > 0 ? listPaths([...mcpServerKeys].sort()) : "(none)"}.`
+        });
+      }
+      const prefix = `${check.mcp}_`;
+      if (check.tool.startsWith(prefix)) {
+        issues.push({
+          check: "health-check-double-qualified",
+          message: `${where} sets mcp "${check.mcp}" and tool "${check.tool}", which already ` + `starts with "${prefix}". When "mcp" is set, "tool" should be the bare tool ` + `name \u2014 OpenCode resolves it to "${prefix}${check.tool}". Did you mean ` + `tool: "${check.tool.slice(prefix.length)}"?`
+        });
+      }
+    });
+  }
+  return issues;
+}
 function routeTargets(policy) {
   const keys = [];
   if (policy.defaultEventType === "route" && typeof policy.defaultEventParamsJson?.["pipelineKey"] === "string") {
@@ -388,6 +418,7 @@ function validateDefinitionSpecs(specs, options = {}) {
   }
   return [
     ...checkSignalSourcePaths(specs.steps),
+    ...checkHealthChecks(specs.steps),
     ...checkRouteTargets(specs.pipelines, options.knownPipelineKeys ?? []),
     ...checkSignalBindings(specs.pipelines, stepsByKey)
   ];

package/dist/definitions/validation/validate-definition-specs.d.ts

@@ -13,7 +13,7 @@ export type ValidateDefinitionSpecsOptions = {
     readonly knownPipelineKeys?: readonly string[];
 };
 export type DefinitionValidationIssue = {
-    readonly check: "signal-source-path" | "route-target" | "signal-binding";
+    readonly check: "signal-source-path" | "route-target" | "signal-binding" | "health-check-mcp-server" | "health-check-double-qualified";
     readonly message: string;
 };
 /**

package/dist/generated/types.gen.d.ts

@@ -1409,6 +1409,16 @@ export type GetApiStepDefinitionsResponses = {
             };
         } | unknown;
         opencodePluginJson: Array<string | Array<unknown>> | unknown;
+        healthChecksJson: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: 'required' | 'warn';
+            timeoutMs: number;
+        }> | unknown;
         status: 'draft' | 'active' | 'archived';
         signalExtractorDefinitions: Array<{
             id: string;
@@ -1465,6 +1475,16 @@ export type PostApiStepDefinitionsData = {
             };
         } | unknown;
         opencodePluginJson?: Array<string | Array<unknown>> | unknown;
+        healthChecksJson?: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: 'required' | 'warn';
+            timeoutMs: number;
+        }> | unknown;
         status: 'draft' | 'active' | 'archived';
         signalExtractorDefinitions: Array<{
             key: string;
@@ -1637,6 +1657,16 @@ export type PostApiStepDefinitionsResponses = {
             };
         } | unknown;
         opencodePluginJson: Array<string | Array<unknown>> | unknown;
+        healthChecksJson: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: 'required' | 'warn';
+            timeoutMs: number;
+        }> | unknown;
         status: 'draft' | 'active' | 'archived';
         signalExtractorDefinitions: Array<{
             id: string;
@@ -1693,6 +1723,16 @@ export type PutApiStepDefinitionsData = {
             };
         } | unknown;
         opencodePluginJson?: Array<string | Array<unknown>> | unknown;
+        healthChecksJson?: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: 'required' | 'warn';
+            timeoutMs: number;
+        }> | unknown;
         status: 'draft' | 'active' | 'archived';
         signalExtractorDefinitions: Array<{
             key: string;
@@ -1833,6 +1873,16 @@ export type PutApiStepDefinitionsResponses = {
             };
         } | unknown;
         opencodePluginJson: Array<string | Array<unknown>> | unknown;
+        healthChecksJson: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: 'required' | 'warn';
+            timeoutMs: number;
+        }> | unknown;
         status: 'draft' | 'active' | 'archived';
         signalExtractorDefinitions: Array<{
             id: string;
@@ -1984,6 +2034,16 @@ export type GetApiStepDefinitionsByStepDefinitionIdResponses = {
             };
         } | unknown;
         opencodePluginJson: Array<string | Array<unknown>> | unknown;
+        healthChecksJson: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: 'required' | 'warn';
+            timeoutMs: number;
+        }> | unknown;
         status: 'draft' | 'active' | 'archived';
         signalExtractorDefinitions: Array<{
             id: string;
@@ -2135,6 +2195,16 @@ export type PutApiStepDefinitionsByStepDefinitionIdArchiveResponses = {
             };
         } | unknown;
         opencodePluginJson: Array<string | Array<unknown>> | unknown;
+        healthChecksJson: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: 'required' | 'warn';
+            timeoutMs: number;
+        }> | unknown;
         status: 'draft' | 'active' | 'archived';
         signalExtractorDefinitions: Array<{
             id: string;
@@ -3352,11 +3422,6 @@ export type PostApiStepExecutionsByStepExecutionIdWorkerContextResponses = {
                     targetPort: number;
                     protocol: 'tcp' | 'http';
                 };
-                healthcheck: {
-                    protocol: 'tcp' | 'http';
-                    path: string | unknown;
-                    expectedStatus: number | unknown;
-                };
             }>;
         };
         stepExecution: {
@@ -3402,6 +3467,16 @@ export type PostApiStepExecutionsByStepExecutionIdWorkerContextResponses = {
                 };
             } | unknown;
             opencodePluginJson: Array<string | Array<unknown>> | unknown;
+            healthChecksJson: Array<{
+                tool: string;
+                mcp?: string;
+                name?: string;
+                args?: {
+                    [key: string]: unknown;
+                };
+                severity: 'required' | 'warn';
+                timeoutMs: number;
+            }> | unknown;
         };
         agentPrompt: {
             sessionTitle: string;
@@ -11542,6 +11617,16 @@ export type GetApiStepDefinitionTemplatesResponses = {
             };
         } | unknown;
         opencodePluginJson: Array<string | Array<unknown>> | unknown;
+        healthChecksJson: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: 'required' | 'warn';
+            timeoutMs: number;
+        }> | unknown;
         signalExtractorDefinitions: Array<{
             key: string;
             sourcePath: string;
@@ -11678,6 +11763,16 @@ export type GetApiStepDefinitionTemplatesByStepDefinitionTemplateIdResponses = {
             };
         } | unknown;
         opencodePluginJson: Array<string | Array<unknown>> | unknown;
+        healthChecksJson: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: 'required' | 'warn';
+            timeoutMs: number;
+        }> | unknown;
         signalExtractorDefinitions: Array<{
             key: string;
             sourcePath: string;
@@ -11872,6 +11967,16 @@ export type PostApiStepDefinitionTemplatesByStepDefinitionTemplateIdInstantiateR
             };
         } | unknown;
         opencodePluginJson: Array<string | Array<unknown>> | unknown;
+        healthChecksJson: Array<{
+            tool: string;
+            mcp?: string;
+            name?: string;
+            args?: {
+                [key: string]: unknown;
+            };
+            severity: 'required' | 'warn';
+            timeoutMs: number;
+        }> | unknown;
         status: 'draft' | 'active' | 'archived';
         signalExtractorDefinitions: Array<{
             id: string;

package/dist/health-checks.d.ts

@@ -0,0 +1,45 @@
+import { z } from "zod";
+/**
+ * Severity of a step-declared health check.
+ *
+ * `required` (default) fails the step immediately if the check fails.
+ * `warn` is advisory — it is reported but never fails the step.
+ */
+export declare const healthCheckSeverityValues: readonly ["required", "warn"];
+export type HealthCheckSeverity = (typeof healthCheckSeverityValues)[number];
+/**
+ * A single step-declared health check: a real tool call made against the
+ * launched environment before the agent starts working.
+ *
+ * `tool` is a bare tool name when `mcp` is set (resolved at runtime to
+ * `${mcp}_${tool}`, matching OpenCode's MCP tool-naming convention), or a flat
+ * tool id otherwise (plugin tools, standalone tools, built-ins already share
+ * one flat namespace, so no qualifier applies).
+ */
+export declare const healthCheckSchema: z.ZodObject<{
+    tool: z.ZodString;
+    mcp: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    severity: z.ZodDefault<z.ZodEnum<{
+        required: "required";
+        warn: "warn";
+    }>>;
+    timeoutMs: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+/**
+ * The full value of a step's `healthChecks` field.
+ */
+export declare const healthChecksSchema: z.ZodArray<z.ZodObject<{
+    tool: z.ZodString;
+    mcp: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    severity: z.ZodDefault<z.ZodEnum<{
+        required: "required";
+        warn: "warn";
+    }>>;
+    timeoutMs: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>>;
+export type HealthCheck = z.infer<typeof healthCheckSchema>;
+export type HealthChecks = z.infer<typeof healthChecksSchema>;