bopodev-agent-sdk 0.1.28 → 0.1.30

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
 
-> bopodev-agent-sdk@0.1.28 build /Users/danielkrusenstrahle/Documents/Projects/Monorepo/bopodev/packages/agent-sdk
+> bopodev-agent-sdk@0.1.30 build /Users/danielkrusenstrahle/Documents/Projects/Monorepo/bopohq/packages/agent-sdk
 > tsc -p tsconfig.json --emitDeclarationOnly
 

package/.turbo/turbo-lint.log

@@ -0,0 +1,4 @@
+
+> bopodev-agent-sdk@0.1.15 lint /Users/danielkrusenstrahle/Documents/Projects/Monorepo/bopohq/packages/agent-sdk
+> tsc -p tsconfig.json --noEmit
+

package/.turbo/turbo-typecheck.log

@@ -1,4 +1,4 @@
 
-> bopodev-agent-sdk@0.1.20 typecheck /Users/danielkrusenstrahle/Documents/Projects/Monorepo/bopodev/packages/agent-sdk
+> bopodev-agent-sdk@0.1.29 typecheck /Users/danielkrusenstrahle/Documents/Projects/Monorepo/bopohq/packages/agent-sdk
 > tsc -p tsconfig.json --noEmit
 

package/dist/adapters/codex/src/server/quota.d.ts

@@ -0,0 +1,2 @@
+import type { AgentRuntimeConfig, AdapterQuotaProbeResult } from "../../../../agent-sdk/src/types";
+export declare function probeQuota(runtime?: AgentRuntimeConfig): Promise<AdapterQuotaProbeResult>;

package/dist/adapters/openclaw-gateway/src/cli/format-event.d.ts

@@ -0,0 +1 @@
+export declare function formatStdoutEvent(line: string, debug: boolean): void;

package/dist/adapters/openclaw-gateway/src/cli/index.d.ts

@@ -0,0 +1 @@
+export { formatStdoutEvent } from "./format-event";

package/dist/adapters/openclaw-gateway/src/index.d.ts

@@ -0,0 +1,7 @@
+import type { AdapterMetadata, AdapterModule } from "../../../agent-sdk/src/types";
+export declare const type: "openclaw_gateway";
+export declare const label = "OpenClaw Gateway";
+export declare const models: readonly [];
+export declare const agentConfigurationDoc = "Use when:\n- You run a self-hosted [OpenClaw](https://docs.openclaw.ai/) gateway and want Bopo heartbeats to invoke `agent` / `agent.wait` over the documented WebSocket protocol.\n\nConfigure:\n- **Command**: WebSocket URL (e.g. `ws://127.0.0.1:18789`). Alternatively set `OPENCLAW_GATEWAY_URL` in runtime environment.\n- **Runtime environment**: `OPENCLAW_GATEWAY_TOKEN` or `OPENCLAW_GATEWAY_PASSWORD` (required). Optional: `OPENCLAW_AGENT_ID`, `OPENCLAW_SESSION_KEY`, `OPENCLAW_SESSION_KEY_STRATEGY` (`issue` | `run` | `fixed`), `OPENCLAW_AGENT_WAIT_MS`, `OPENCLAW_DEVICE_PRIVATE_KEY_PEM` (stable device identity), `BOPO_OPENCLAW_DISABLE_DEVICE_AUTH=1` only if your gateway explicitly allows insecure mode.\n\nDo not use when:\n- You need a local CLI subprocess adapter \u2014 use Codex, Claude Code, or OpenCode instead.";
+export declare const metadata: AdapterMetadata;
+export declare const openclawGatewayAdapterModule: AdapterModule;

package/dist/adapters/openclaw-gateway/src/server/device-auth.d.ts

@@ -0,0 +1,25 @@
+export declare function publicKeyRawBase64UrlFromPem(publicKeyPem: string): string;
+export declare function signDevicePayload(privateKeyPem: string, payload: string): string;
+export type OpenClawDeviceIdentity = {
+    deviceId: string;
+    publicKeyPem: string;
+    privateKeyPem: string;
+};
+export declare function generateEphemeralDeviceIdentity(): OpenClawDeviceIdentity;
+export declare function loadDeviceIdentityFromPrivateKeyPem(privateKeyPem: string): OpenClawDeviceIdentity;
+/**
+ * OpenClaw gateway device signing payload (v3), compatible with gateway verification.
+ * @see https://docs.openclaw.ai/gateway/protocol
+ */
+export declare function buildOpenClawDeviceAuthPayloadV3(params: {
+    deviceId: string;
+    clientId: string;
+    clientMode: string;
+    role: string;
+    scopes: string[];
+    signedAtMs: number;
+    token?: string | null;
+    nonce: string;
+    platform?: string | null;
+    deviceFamily?: string | null;
+}): string;

package/dist/adapters/openclaw-gateway/src/server/execute.d.ts

@@ -0,0 +1,2 @@
+import type { HeartbeatContext, AdapterExecutionResult } from "../../../../agent-sdk/src/types";
+export declare function execute(context: HeartbeatContext): Promise<AdapterExecutionResult>;

package/dist/adapters/openclaw-gateway/src/server/gateway-client.d.ts

@@ -0,0 +1,56 @@
+import { type ParsedOpenClawSessionUsage } from "./parse";
+export declare class GatewayResponseError extends Error {
+    readonly gatewayCode?: string;
+    readonly gatewayDetails?: unknown;
+    constructor(message: string, gatewayCode?: string, gatewayDetails?: unknown);
+}
+export type OpenClawGatewayRunOptions = {
+    gatewayUrl: string;
+    token?: string | null;
+    password?: string | null;
+    devicePrivateKeyPem?: string | null;
+    /** When true, omit `device` on `connect` (gateway must allow disabled device auth). */
+    disableDeviceAuth?: boolean;
+    agentId?: string | null;
+    /** For `sessionKeyStrategy: "fixed"` — OpenClaw session key string. */
+    openclawSessionKey?: string | null;
+    sessionKeyStrategy?: "issue" | "run" | "fixed";
+    primaryIssueId?: string | null;
+    /** OpenClaw `agent.timeout` (seconds). */
+    agentTimeoutSec?: number | null;
+    model?: string | null;
+    message: string;
+    idempotencyKey: string;
+    connectTimeoutMs: number;
+    agentWaitTimeoutMs: number;
+    onStdoutLine: (line: string) => void;
+    onTranscriptEvent?: (event: {
+        kind: "system" | "assistant" | "thinking" | "tool_call" | "tool_result" | "result" | "stderr";
+        label?: string;
+        text?: string;
+        payload?: string;
+        signalLevel?: "high" | "medium" | "low" | "noise";
+        groupKey?: string;
+        source?: "stdout" | "stderr";
+    }) => void;
+    abortSignal?: AbortSignal;
+};
+export type OpenClawGatewayRunResult = {
+    ok: boolean;
+    summary: string;
+    runId?: string;
+    timedOut?: boolean;
+    errorMessage?: string;
+    tokenInput: number;
+    tokenOutput: number;
+    /** Cache / context read tokens when reported by `sessions.usage`. */
+    cachedInputTokens: number;
+    usdCost: number;
+    model?: string | null;
+    /** Resolved OpenClaw runtime model provider (e.g. anthropic), when available. */
+    openclawModelProvider?: string | null;
+    provider?: string | null;
+    /** Where token/model/cost metadata came from, for traces. */
+    openclawUsageSource?: ParsedOpenClawSessionUsage["source"] | "none";
+};
+export declare function runOpenClawGatewayTurn(options: OpenClawGatewayRunOptions): Promise<OpenClawGatewayRunResult>;

package/dist/adapters/openclaw-gateway/src/server/index.d.ts

@@ -0,0 +1,2 @@
+export { execute } from "./execute";
+export { testEnvironment } from "./test";

package/dist/adapters/openclaw-gateway/src/server/parse.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Parse OpenClaw gateway JSON payloads for session usage (tokens, model, cost).
+ * Shapes follow `sessions.list` / `sessions.usage` responses on the gateway WebSocket API.
+ */
+export type ParsedOpenClawSessionUsage = {
+    tokenInput: number;
+    tokenOutput: number;
+    cachedInputTokens: number;
+    usdCost: number;
+    model: string | null;
+    modelProvider: string | null;
+    source: "sessions.list" | "sessions.usage";
+};
+/** Match `GatewaySessionRow` from OpenClaw `sessions.list` (search + exact key). */
+export declare function extractUsageFromSessionsList(payload: unknown, exactSessionKey: string): ParsedOpenClawSessionUsage | null;
+/** Match `SessionUsageEntry` from OpenClaw `sessions.usage` when `key` is scoped. */
+export declare function extractUsageFromSessionsUsage(payload: unknown, exactSessionKey: string): ParsedOpenClawSessionUsage | null;
+/**
+ * Map OpenClaw session `modelProvider` strings to Bopo `pricingProviderType` when catalog pricing should apply.
+ * Returns `null` when unknown so heartbeat cost logic falls back to gateway-reported USD or `openclaw_gateway` defaults.
+ */
+export declare function mapOpenClawModelProviderToBopoPricingType(openclawProvider: string | null | undefined): string | null;

package/dist/adapters/openclaw-gateway/src/server/test.d.ts

@@ -0,0 +1,2 @@
+import type { AdapterEnvironmentResult, AgentRuntimeConfig } from "../../../../agent-sdk/src/types";
+export declare function testEnvironment(runtime?: AgentRuntimeConfig): Promise<AdapterEnvironmentResult>;

package/dist/adapters/openclaw-gateway/src/ui/build-config.d.ts

@@ -0,0 +1,3 @@
+export declare function buildAdapterConfig(values: Record<string, unknown>): {
+    [x: string]: unknown;
+};

package/dist/adapters/openclaw-gateway/src/ui/index.d.ts

@@ -0,0 +1,2 @@
+export { parseStdoutLine } from "./parse-stdout";
+export { buildAdapterConfig } from "./build-config";

package/dist/adapters/openclaw-gateway/src/ui/parse-stdout.d.ts

@@ -0,0 +1,6 @@
+export declare function parseStdoutLine(line: string, timestampIso: string): {
+    kind: string;
+    label: string;
+    text: string;
+    timestampIso: string;
+}[];

package/dist/adapters/opencode/src/index.d.ts

@@ -1,7 +1,11 @@
 import type { AdapterMetadata, AdapterModule } from "../../../agent-sdk/src/types";
 export declare const type: "opencode";
 export declare const label = "OpenCode";
-export declare const models: readonly [];
+/** Shown when `opencode models` is empty (e.g. CLI missing on the API host). Discovery merges on top of this. */
+export declare const models: readonly [{
+    readonly id: "opencode/big-pickle";
+    readonly label: "Big Pickle";
+}];
 export declare const agentConfigurationDoc = "Use when:\n- You need OpenCode CLI execution with provider/model selection.\n- You want OpenCode session reuse.\n\nDo not use when:\n- No runtime model is configured.\n- The host cannot run OpenCode CLI.";
 export declare const metadata: AdapterMetadata;
 export declare const opencodeAdapterModule: AdapterModule;

package/dist/agent-sdk/src/quota.d.ts

@@ -0,0 +1,4 @@
+import type { AgentProviderType, AdapterQuotaProbeResult, AgentRuntimeConfig } from "./types";
+export declare function createUnsupportedQuotaProbeResult(providerType: AgentProviderType, message: string): AdapterQuotaProbeResult;
+export declare function createAuthRequiredQuotaProbeResult(providerType: AgentProviderType, message: string): AdapterQuotaProbeResult;
+export declare function resolveMergedEnv(runtime?: AgentRuntimeConfig): NodeJS.ProcessEnv;

package/dist/agent-sdk/src/types.d.ts

@@ -4,6 +4,10 @@ export interface AgentWorkItem {
     issueId: string;
     projectId: string;
     parentIssueId?: string | null;
+    /** Linked planning goals for this issue, if any. */
+    goalIds?: string[];
+    /** Root-to-leaf chain per linked goal (same order as goalIds). */
+    goalAncestryChains?: string[][];
     childIssueIds?: string[];
     projectName?: string | null;
     title: string;
@@ -75,6 +79,15 @@ export interface HeartbeatContext {
         commentBody?: string | null;
         issueIds?: string[];
     };
+    /** Company agents (non-terminated), sorted by name; used for delegation and task routing hints. */
+    teamRoster?: Array<{
+        id: string;
+        name: string;
+        role: string;
+        title?: string | null;
+        capabilities?: string | null;
+        status: string;
+    }>;
 }
 /**
  * Normalized usage contract produced by adapter execution.

package/dist/contracts/src/index.d.ts

@@ -127,8 +127,10 @@ export declare const IssueSchema: z.ZodObject<{
     companyId: z.ZodString;
     projectId: z.ZodString;
     parentIssueId: z.ZodNullable<z.ZodString>;
+    goalIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
     title: z.ZodString;
     body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    externalLink: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodEnum<{
         blocked: "blocked";
         todo: "todo";
@@ -192,8 +194,10 @@ export declare const IssueDetailSchema: z.ZodObject<{
     companyId: z.ZodString;
     projectId: z.ZodString;
     parentIssueId: z.ZodNullable<z.ZodString>;
+    goalIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
     title: z.ZodString;
     body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    externalLink: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodEnum<{
         blocked: "blocked";
         todo: "todo";
@@ -310,6 +314,7 @@ export declare const GoalSchema: z.ZodObject<{
     companyId: z.ZodString;
     projectId: z.ZodNullable<z.ZodString>;
     parentGoalId: z.ZodNullable<z.ZodString>;
+    ownerAgentId: z.ZodNullable<z.ZodString>;
     level: z.ZodEnum<{
         agent: "agent";
         company: "company";
@@ -400,6 +405,7 @@ export declare const TemplateManifestAgentSchema: z.ZodObject<{
         general: "general";
     }>>;
     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodString;
     providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
         claude_code: "claude_code";
@@ -409,6 +415,7 @@ export declare const TemplateManifestAgentSchema: z.ZodObject<{
         gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
+        openclaw_gateway: "openclaw_gateway";
         http: "http";
         shell: "shell";
     }>>>;
@@ -527,6 +534,7 @@ export declare const TemplateManifestSchema: z.ZodObject<{
             general: "general";
         }>>;
         title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         name: z.ZodString;
         providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
             claude_code: "claude_code";
@@ -536,6 +544,7 @@ export declare const TemplateManifestSchema: z.ZodObject<{
             gemini_cli: "gemini_cli";
             openai_api: "openai_api";
             anthropic_api: "anthropic_api";
+            openclaw_gateway: "openclaw_gateway";
             http: "http";
             shell: "shell";
         }>>>;
@@ -687,6 +696,7 @@ export declare const TemplateSchema: z.ZodObject<{
                 general: "general";
             }>>;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             name: z.ZodString;
             providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                 claude_code: "claude_code";
@@ -696,6 +706,7 @@ export declare const TemplateSchema: z.ZodObject<{
                 gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
+                openclaw_gateway: "openclaw_gateway";
                 http: "http";
                 shell: "shell";
             }>>>;
@@ -847,6 +858,7 @@ export declare const TemplateCreateRequestSchema: z.ZodObject<{
                 general: "general";
             }>>;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             name: z.ZodString;
             providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                 claude_code: "claude_code";
@@ -856,6 +868,7 @@ export declare const TemplateCreateRequestSchema: z.ZodObject<{
                 gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
+                openclaw_gateway: "openclaw_gateway";
                 http: "http";
                 shell: "shell";
             }>>>;
@@ -1005,6 +1018,7 @@ export declare const TemplateUpdateRequestSchema: z.ZodObject<{
                 general: "general";
             }>>;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             name: z.ZodString;
             providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                 claude_code: "claude_code";
@@ -1014,6 +1028,7 @@ export declare const TemplateUpdateRequestSchema: z.ZodObject<{
                 gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
+                openclaw_gateway: "openclaw_gateway";
                 http: "http";
                 shell: "shell";
             }>>>;
@@ -1214,6 +1229,7 @@ export declare const TemplateExportSchema: z.ZodObject<{
                     general: "general";
                 }>>;
                 title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 name: z.ZodString;
                 providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                     claude_code: "claude_code";
@@ -1223,6 +1239,7 @@ export declare const TemplateExportSchema: z.ZodObject<{
                     gemini_cli: "gemini_cli";
                     openai_api: "openai_api";
                     anthropic_api: "anthropic_api";
+                    openclaw_gateway: "openclaw_gateway";
                     http: "http";
                     shell: "shell";
                 }>>>;
@@ -1376,6 +1393,7 @@ export declare const TemplateImportRequestSchema: z.ZodObject<{
                         general: "general";
                     }>>;
                     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                     name: z.ZodString;
                     providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                         claude_code: "claude_code";
@@ -1385,6 +1403,7 @@ export declare const TemplateImportRequestSchema: z.ZodObject<{
                         gemini_cli: "gemini_cli";
                         openai_api: "openai_api";
                         anthropic_api: "anthropic_api";
+                        openclaw_gateway: "openclaw_gateway";
                         http: "http";
                         shell: "shell";
                     }>>>;
@@ -1515,6 +1534,7 @@ export declare const TemplateVersionSchema: z.ZodObject<{
                 general: "general";
             }>>;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             name: z.ZodString;
             providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                 claude_code: "claude_code";
@@ -1524,6 +1544,7 @@ export declare const TemplateVersionSchema: z.ZodObject<{
                 gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
+                openclaw_gateway: "openclaw_gateway";
                 http: "http";
                 shell: "shell";
             }>>>;
@@ -1629,6 +1650,7 @@ export declare const ProviderTypeSchema: z.ZodEnum<{
     gemini_cli: "gemini_cli";
     openai_api: "openai_api";
     anthropic_api: "anthropic_api";
+    openclaw_gateway: "openclaw_gateway";
     http: "http";
     shell: "shell";
 }>;
@@ -1827,6 +1849,7 @@ export declare const RunManagerReportSchema: z.ZodObject<{
         gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
+        openclaw_gateway: "openclaw_gateway";
         http: "http";
         shell: "shell";
     }>;
@@ -1904,6 +1927,7 @@ export declare const RunCompletionReportSchema: z.ZodObject<{
             gemini_cli: "gemini_cli";
             openai_api: "openai_api";
             anthropic_api: "anthropic_api";
+            openclaw_gateway: "openclaw_gateway";
             http: "http";
             shell: "shell";
         }>;
@@ -2160,6 +2184,7 @@ export declare const AgentCreateRequestSchema: z.ZodObject<{
         general: "general";
     }>>;
     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodString;
     providerType: z.ZodEnum<{
         claude_code: "claude_code";
@@ -2169,6 +2194,7 @@ export declare const AgentCreateRequestSchema: z.ZodObject<{
         gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
+        openclaw_gateway: "openclaw_gateway";
         http: "http";
         shell: "shell";
     }>;
@@ -2204,10 +2230,12 @@ export declare const AgentCreateRequestSchema: z.ZodObject<{
             gemini_cli: "gemini_cli";
             openai_api: "openai_api";
             anthropic_api: "anthropic_api";
+            openclaw_gateway: "openclaw_gateway";
             http: "http";
             shell: "shell";
         }>>>;
         requestedRuntimeModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        requestedCapabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
     requestApproval: z.ZodDefault<z.ZodBoolean>;
     runtimeConfig: z.ZodDefault<z.ZodObject<{
@@ -2252,6 +2280,7 @@ export declare const AgentUpdateRequestSchema: z.ZodObject<{
         general: "general";
     }>>>;
     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodOptional<z.ZodString>;
     providerType: z.ZodOptional<z.ZodEnum<{
         claude_code: "claude_code";
@@ -2261,6 +2290,7 @@ export declare const AgentUpdateRequestSchema: z.ZodObject<{
         gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
+        openclaw_gateway: "openclaw_gateway";
         http: "http";
         shell: "shell";
     }>>;
@@ -2317,6 +2347,7 @@ export declare const AgentSchema: z.ZodObject<{
         general: "general";
     }>>>;
     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodString;
     providerType: z.ZodEnum<{
         claude_code: "claude_code";
@@ -2326,6 +2357,7 @@ export declare const AgentSchema: z.ZodObject<{
         gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
+        openclaw_gateway: "openclaw_gateway";
         http: "http";
         shell: "shell";
     }>;
@@ -2823,6 +2855,7 @@ export declare const OfficeOccupantSchema: z.ZodObject<{
         gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
+        openclaw_gateway: "openclaw_gateway";
         http: "http";
         shell: "shell";
     }>>;
@@ -2870,6 +2903,7 @@ export declare const OfficeSpaceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
             gemini_cli: "gemini_cli";
             openai_api: "openai_api";
             anthropic_api: "anthropic_api";
+            openclaw_gateway: "openclaw_gateway";
             http: "http";
             shell: "shell";
         }>>;
@@ -2916,6 +2950,7 @@ export declare const OfficeSpaceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
             gemini_cli: "gemini_cli";
             openai_api: "openai_api";
             anthropic_api: "anthropic_api";
+            openclaw_gateway: "openclaw_gateway";
             http: "http";
             shell: "shell";
         }>>;
@@ -3209,6 +3244,7 @@ export declare const RealtimeEventEnvelopeSchema: z.ZodDiscriminatedUnion<[z.Zod
                 gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
+                openclaw_gateway: "openclaw_gateway";
                 http: "http";
                 shell: "shell";
             }>>;
@@ -3255,6 +3291,7 @@ export declare const RealtimeEventEnvelopeSchema: z.ZodDiscriminatedUnion<[z.Zod
                 gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
+                openclaw_gateway: "openclaw_gateway";
                 http: "http";
                 shell: "shell";
             }>>;
@@ -3636,6 +3673,7 @@ export declare const RealtimeEventMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
                 gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
+                openclaw_gateway: "openclaw_gateway";
                 http: "http";
                 shell: "shell";
             }>>;
@@ -3682,6 +3720,7 @@ export declare const RealtimeEventMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
                 gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
+                openclaw_gateway: "openclaw_gateway";
                 http: "http";
                 shell: "shell";
             }>>;
@@ -4065,6 +4104,7 @@ export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
                 gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
+                openclaw_gateway: "openclaw_gateway";
                 http: "http";
                 shell: "shell";
             }>>;
@@ -4111,6 +4151,7 @@ export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
                 gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
+                openclaw_gateway: "openclaw_gateway";
                 http: "http";
                 shell: "shell";
             }>>;
@@ -4381,6 +4422,7 @@ export declare const CostLedgerEntrySchema: z.ZodObject<{
         gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
+        openclaw_gateway: "openclaw_gateway";
         http: "http";
         shell: "shell";
     }>;
@@ -4663,6 +4705,7 @@ export declare const HeartbeatRunDetailSchema: z.ZodObject<{
                     gemini_cli: "gemini_cli";
                     openai_api: "openai_api";
                     anthropic_api: "anthropic_api";
+                    openclaw_gateway: "openclaw_gateway";
                     http: "http";
                     shell: "shell";
                 }>;

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "bopodev-agent-sdk",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "license": "MIT",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "dependencies": {
-    "bopodev-contracts": "0.1.28"
+    "bopodev-contracts": "0.1.30"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json --emitDeclarationOnly",

package/src/adapters.ts

@@ -11,7 +11,11 @@ import type {
   HeartbeatContext,
   HeartbeatPromptMode
 } from "./types";
-import { ExecutionOutcomeSchema, type ExecutionOutcome } from "bopodev-contracts";
+import {
+  ExecutionOutcomeSchema,
+  type AgentFinalRunOutput,
+  type ExecutionOutcome
+} from "bopodev-contracts";
 import {
   checkRuntimeCommandHealth,
   containsUsageLimitHardStopFailure,
@@ -161,6 +165,32 @@ function toNormalizedUsage(usage: RuntimeParsedUsage | undefined): AdapterNormal
   };
 }
 
+/**
+ * Cursor and Gemini CLIs emit stream-json transcripts with usage, not a standalone heartbeat JSON blob.
+ * When structured usage was resolved from the stream but no final JSON object exists, synthesize the
+ * minimal contract shape so downstream heartbeat persistence stays consistent.
+ */
+function synthesizeStreamFinalRunOutput(
+  provider: AgentProviderType,
+  parsedUsage: RuntimeParsedUsage | undefined
+): AgentFinalRunOutput | null {
+  if (provider !== "cursor" && provider !== "gemini_cli") {
+    return null;
+  }
+  if (!parsedUsage) {
+    return null;
+  }
+  const summary =
+    (typeof parsedUsage.summary === "string" && parsedUsage.summary.trim()) ||
+    `${provider} runtime completed.`;
+  return {
+    employee_comment: summary,
+    results: [],
+    errors: [],
+    artifacts: []
+  };
+}
+
 function usageTokenInputTotal(usage: RuntimeParsedUsage | undefined) {
   if (!usage) {
     return 0;
@@ -656,6 +686,15 @@ const staticMetadata: AdapterMetadata[] = [
     supportsThinkingEffort: false,
     requiresRuntimeCwd: false
   },
+  {
+    providerType: "openclaw_gateway",
+    label: "OpenClaw Gateway",
+    supportsModelSelection: false,
+    supportsEnvironmentTest: true,
+    supportsWebSearch: false,
+    supportsThinkingEffort: false,
+    requiresRuntimeCwd: false
+  },
   {
     providerType: "http",
     label: "HTTP",
@@ -678,7 +717,7 @@ const staticMetadata: AdapterMetadata[] = [
 
 const metadataByProviderType = new Map(staticMetadata.map((entry) => [entry.providerType, entry] as const));
 
-const modelCatalog: Record<Exclude<AgentProviderType, "http" | "shell">, AdapterModelOption[]> = {
+const modelCatalog: Record<Exclude<AgentProviderType, "http" | "shell" | "openclaw_gateway">, AdapterModelOption[]> = {
   codex: [
     { id: "gpt-5.3-codex", label: "GPT-5.3 Codex" },
     { id: "gpt-5.4", label: "GPT-5.4" },
@@ -741,7 +780,7 @@ export async function listAdapterModels(
   providerType: AgentProviderType,
   runtime?: AgentRuntimeConfig
 ): Promise<AdapterModelOption[]> {
-  if (providerType === "http" || providerType === "shell") {
+  if (providerType === "http" || providerType === "shell" || providerType === "openclaw_gateway") {
     return [];
   }
   if (providerType === "cursor") {
@@ -870,7 +909,10 @@ export async function testAdapterEnvironment(
 
 function detectProviderCommandMismatch(providerType: AgentProviderType, command: string) {
   const normalized = basename(command).toLowerCase();
-  const known: Record<Exclude<AgentProviderType, "http" | "shell" | "openai_api" | "anthropic_api">, string[]> = {
+  const known: Record<
+    Exclude<AgentProviderType, "http" | "shell" | "openai_api" | "anthropic_api" | "openclaw_gateway">,
+    string[]
+  > = {
     claude_code: ["claude", "claude.exe", "claude.cmd"],
     codex: ["codex", "codex.exe", "codex.cmd"],
     cursor: ["cursor", "cursor.exe", "cursor.cmd"],
@@ -1850,7 +1892,9 @@ export function toProviderResult(
         nextState: applyProviderSessionState(context, provider, sessionUpdate)
       };
     }
-    if (!runtime.finalRunOutput) {
+    const resolvedFinalRunOutput =
+      runtime.finalRunOutput ?? synthesizeStreamFinalRunOutput(provider, runtime.parsedUsage);
+    if (!resolvedFinalRunOutput) {
       const usage = toNormalizedUsage(runtime.parsedUsage);
       const detail = resolveFinalRunOutputContractDetail({ provider, runtime });
       return createContractInvalidResult({
@@ -1895,7 +1939,7 @@ export function toProviderResult(
       tokenInput: usageTokenInputTotal(runtime.parsedUsage),
       tokenOutput,
       usdCost,
-      finalRunOutput: runtime.finalRunOutput,
+      finalRunOutput: resolvedFinalRunOutput,
       usage,
       pricingProviderType,
       pricingModelId,
@@ -2646,9 +2690,65 @@ function clipPromptText(text: string, max: number | null): string {
 const HEARTBEAT_JSON_SCHEMA_FOOTER = `At the end of your response, output exactly one JSON object on a single line and nothing else. Use this exact schema:
 {"employee_comment":"markdown update to the manager","results":["short concrete outcome"],"errors":[],"artifacts":[{"kind":"file","path":"relative/path"}]}`;
 
+/** Injected every heartbeat when the runtime sets BOPODEV_AGENT_OPERATING_DIR (no need to store paths in bootstrapPrompt). */
+function buildOperatingDirectoryPromptPrefix(context: HeartbeatContext): string {
+  const dir = context.runtime?.env?.BOPODEV_AGENT_OPERATING_DIR?.trim();
+  if (!dir) {
+    return "";
+  }
+  return [
+    "Operating context:",
+    `- Your agent operating directory (read AGENTS.md, HEARTBEAT.md, SOUL.md, TOOLS.md here when they exist): ${dir}`,
+    ""
+  ].join("\n");
+}
+
+function composeBootstrapPreamble(context: HeartbeatContext): string {
+  const operating = buildOperatingDirectoryPromptPrefix(context);
+  const user = context.runtime?.bootstrapPrompt?.trim();
+  if (!user) {
+    return operating;
+  }
+  return operating ? `${operating}${user}\n\n` : `${user}\n\n`;
+}
+
+function formatTeamRosterSection(context: HeartbeatContext): string {
+  const roster = context.teamRoster;
+  if (!roster?.length) {
+    return "";
+  }
+  const mode = resolveHeartbeatPromptModeForPrompt(context);
+  const isCompact = mode === "compact";
+  const clipCapabilities = (raw: string | null | undefined) => {
+    const t = raw?.trim();
+    if (!t) {
+      return null;
+    }
+    if (isCompact && t.length > 200) {
+      return `${t.slice(0, 200)}…`;
+    }
+    return t;
+  };
+  const lines = roster.map((member) => {
+    const caps = clipCapabilities(member.capabilities);
+    const parts = [member.id, member.name, member.role];
+    const titled = member.title?.trim();
+    if (titled) {
+      parts.push(`title: ${titled}`);
+    }
+    if (caps) {
+      parts.push(`capabilities: ${caps}`);
+    }
+    const you = member.id === context.agentId ? " (you)" : "";
+    return `- ${parts.join(" | ")}${you}`;
+  });
+  return ["Team roster (for delegation):", ...lines, ""].join("\n");
+}
+
 function buildIdleMicroPrompt(context: HeartbeatContext): string {
-  const bootstrapPrompt = context.runtime?.bootstrapPrompt?.trim();
-  return `${bootstrapPrompt ? `${bootstrapPrompt}\n\n` : ""}Idle heartbeat (micro prompt): agent ${context.agentId} (${context.agent.name}) has no assigned issues this run. Summarize readiness in \`employee_comment\`; leave \`results\` empty unless you completed verifiable work. Use \`BOPODEV_*\` for control-plane API calls when needed.
+  const preamble = composeBootstrapPreamble(context);
+  const rosterBlock = formatTeamRosterSection(context);
+  return `${preamble}${rosterBlock}Idle heartbeat (micro prompt): agent ${context.agentId} (${context.agent.name}) has no assigned issues this run. Summarize readiness in \`employee_comment\`; leave \`results\` empty unless you completed verifiable work. Use \`BOPODEV_*\` for control-plane API calls when needed.
 
 ${HEARTBEAT_JSON_SCHEMA_FOOTER}
 `;
@@ -2673,7 +2773,7 @@ export function createPrompt(context: HeartbeatContext) {
   if (context.idleMicroPrompt && context.workItems.length === 0 && !isCommentOrderRunEarly) {
     return buildIdleMicroPrompt(context);
   }
-  const bootstrapPrompt = context.runtime?.bootstrapPrompt?.trim();
+  const bootstrapPreamble = composeBootstrapPreamble(context);
   const promptMode = resolveHeartbeatPromptModeForPrompt(context);
   const isCompact = promptMode === "compact";
   const memoryCap = resolveMemorySectionMaxChars(promptMode);
@@ -2696,6 +2796,11 @@ export function createPrompt(context: HeartbeatContext) {
             `- [${item.issueId}] ${item.title}`,
             `  Project: ${item.projectName ?? item.projectId}`,
             item.parentIssueId ? `  Parent issue: ${item.parentIssueId}` : null,
+            ...(item.goalAncestryChains && item.goalAncestryChains.length > 0
+              ? item.goalAncestryChains.map(
+                  (chain, idx) => `  Linked goal ${idx + 1} (root → leaf): ${chain.join(" → ")}`
+                )
+              : []),
             item.childIssueIds?.length ? `  Sub-issues: ${item.childIssueIds.join(", ")}` : null,
             item.status ? `  Status: ${item.status}` : null,
             item.priority ? `  Priority: ${item.priority}` : null,
@@ -2785,6 +2890,8 @@ export function createPrompt(context: HeartbeatContext) {
       : "- BOPODEV_REQUEST_HEADERS_JSON is missing. Report this as blocker."
   ].join("\n");
 
+  const teamRosterBlock = formatTeamRosterSection(context);
+
   const executionDirectives = [
     "Execution directives:",
     "- You are running inside a BopoDev heartbeat for local repository work.",
@@ -2819,14 +2926,14 @@ export function createPrompt(context: HeartbeatContext) {
     "- Do not invent token or cost values; the runtime records usage separately."
   ].join("\n");
 
-  return `${bootstrapPrompt ? `${bootstrapPrompt}\n\n` : ""}You are ${context.agent.name} (${context.agent.role}), agent ${context.agentId}.
+  return `${bootstrapPreamble}You are ${context.agent.name} (${context.agent.role}), agent ${context.agentId}.
 Heartbeat run ${context.heartbeatRunId}.
 ${isCompact ? "Prompt profile: compact (issue bodies are not inlined—use GET /issues/:id to hydrate).\n" : ""}
 Company:
 - Name: ${context.company.name}
 - Mission: ${context.company.mission ?? "No mission set"}
 
-Goal context:
+${teamRosterBlock}Goal context:
 Company goals:
 ${companyGoals}
 Project goals:

package/src/registry.ts

@@ -1,3 +1,4 @@
+import { dedupeModels } from "./adapters";
 import type {
   AdapterEnvironmentResult,
   AdapterMetadata,
@@ -16,6 +17,7 @@ import { openaiapiAdapterModule } from "../../adapters/openai-api/src";
 import { anthropicapiAdapterModule } from "../../adapters/anthropic-api/src";
 import { httpAdapterModule } from "../../adapters/http/src";
 import { shellAdapterModule } from "../../adapters/shell/src";
+import { openclawGatewayAdapterModule } from "../../adapters/openclaw-gateway/src";
 
 const adapterModules: Record<AgentProviderType, AdapterModule> = {
   claude_code: claudecodeAdapterModule,
@@ -25,6 +27,7 @@ const adapterModules: Record<AgentProviderType, AdapterModule> = {
   gemini_cli: geminiCliAdapterModule,
   openai_api: openaiapiAdapterModule,
   anthropic_api: anthropicapiAdapterModule,
+  openclaw_gateway: openclawGatewayAdapterModule,
   http: httpAdapterModule,
   shell: shellAdapterModule
 };
@@ -62,6 +65,10 @@ const adapters: Record<AgentProviderType, AgentAdapter> = {
     providerType: "anthropic_api",
     execute: (context) => adapterModules.anthropic_api.server.execute(context)
   },
+  openclaw_gateway: {
+    providerType: "openclaw_gateway",
+    execute: (context) => adapterModules.openclaw_gateway.server.execute(context)
+  },
   http: {
     providerType: "http",
     execute: (context) => adapterModules.http.server.execute(context)
@@ -80,11 +87,19 @@ export async function getAdapterModels(
   providerType: AgentProviderType,
   runtime?: AgentRuntimeConfig
 ): Promise<AdapterModelOption[]> {
-  const fromModule = await adapterModules[providerType].server.listModels?.(runtime);
-  if (fromModule) {
-    return fromModule;
+  const mod = adapterModules[providerType];
+  const staticModels: AdapterModelOption[] = mod.models ? [...mod.models] : [];
+  const listModels = mod.server.listModels;
+  if (!listModels) {
+    return staticModels;
+  }
+  const discovered = await listModels(runtime);
+  const disc = Array.isArray(discovered) ? discovered : [];
+  if (disc.length > 0) {
+    return dedupeModels([...disc, ...staticModels]);
   }
-  return adapterModules[providerType].models ? [...adapterModules[providerType].models] : [];
+  // Empty discovery (CLI missing, auth, timeout): keep static catalog so UIs are not stuck on client-only allowlists.
+  return staticModels.length > 0 ? staticModels : disc;
 }
 
 export function getAdapterMetadata(): AdapterMetadata[] {

package/src/types.ts

@@ -6,6 +6,10 @@ export interface AgentWorkItem {
   issueId: string;
   projectId: string;
   parentIssueId?: string | null;
+  /** Linked planning goals for this issue, if any. */
+  goalIds?: string[];
+  /** Root-to-leaf chain per linked goal (same order as goalIds). */
+  goalAncestryChains?: string[][];
   childIssueIds?: string[];
   projectName?: string | null;
   title: string;
@@ -81,6 +85,15 @@ export interface HeartbeatContext {
     commentBody?: string | null;
     issueIds?: string[];
   };
+  /** Company agents (non-terminated), sorted by name; used for delegation and task routing hints. */
+  teamRoster?: Array<{
+    id: string;
+    name: string;
+    role: string;
+    title?: string | null;
+    capabilities?: string | null;
+    status: string;
+  }>;
 }
 
 /**