bopodev-agent-sdk 0.1.29 → 0.1.31

package/.turbo/turbo-build.log

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

package/.turbo/turbo-lint.log

@@ -1,4 +1,4 @@
 
-> bopodev-agent-sdk@0.1.28 lint /Users/danielkrusenstrahle/Documents/Projects/Monorepo/bopodev/packages/agent-sdk
+> 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.30 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

@@ -79,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

@@ -149,9 +149,190 @@ export declare const IssueSchema: z.ZodObject<{
     assigneeAgentId: z.ZodNullable<z.ZodString>;
     labels: z.ZodDefault<z.ZodArray<z.ZodString>>;
     tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    loopId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    loopRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
+export declare const WorkLoopConcurrencyPolicySchema: z.ZodEnum<{
+    coalesce_if_active: "coalesce_if_active";
+    skip_if_active: "skip_if_active";
+    always_enqueue: "always_enqueue";
+}>;
+export declare const WorkLoopCatchUpPolicySchema: z.ZodEnum<{
+    skip_missed: "skip_missed";
+    enqueue_missed_with_cap: "enqueue_missed_with_cap";
+}>;
+export declare const WorkLoopStatusSchema: z.ZodEnum<{
+    active: "active";
+    paused: "paused";
+    archived: "archived";
+}>;
+export declare const WorkLoopSchema: z.ZodObject<{
+    id: z.ZodString;
+    companyId: z.ZodString;
+    projectId: z.ZodString;
+    parentIssueId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    goalIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    assigneeAgentId: z.ZodString;
+    priority: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        paused: "paused";
+        archived: "archived";
+    }>;
+    concurrencyPolicy: z.ZodEnum<{
+        coalesce_if_active: "coalesce_if_active";
+        skip_if_active: "skip_if_active";
+        always_enqueue: "always_enqueue";
+    }>;
+    catchUpPolicy: z.ZodEnum<{
+        skip_missed: "skip_missed";
+        enqueue_missed_with_cap: "enqueue_missed_with_cap";
+    }>;
+    lastTriggeredAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const WorkLoopTriggerSchema: z.ZodObject<{
+    id: z.ZodString;
+    companyId: z.ZodString;
+    workLoopId: z.ZodString;
+    kind: z.ZodString;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    enabled: z.ZodBoolean;
+    cronExpression: z.ZodString;
+    timezone: z.ZodString;
+    nextRunAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastFiredAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastResult: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const WorkLoopRunSchema: z.ZodObject<{
+    id: z.ZodString;
+    companyId: z.ZodString;
+    workLoopId: z.ZodString;
+    triggerId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source: z.ZodEnum<{
+        schedule: "schedule";
+        manual: "manual";
+    }>;
+    status: z.ZodString;
+    triggeredAt: z.ZodString;
+    idempotencyKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    linkedIssueId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    coalescedIntoRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    failureReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const WorkLoopCreateRequestSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    parentIssueId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    goalIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    assigneeAgentId: z.ZodString;
+    priority: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        urgent: "urgent";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        paused: "paused";
+        archived: "archived";
+    }>>;
+    concurrencyPolicy: z.ZodOptional<z.ZodEnum<{
+        coalesce_if_active: "coalesce_if_active";
+        skip_if_active: "skip_if_active";
+        always_enqueue: "always_enqueue";
+    }>>;
+    catchUpPolicy: z.ZodOptional<z.ZodEnum<{
+        skip_missed: "skip_missed";
+        enqueue_missed_with_cap: "enqueue_missed_with_cap";
+    }>>;
+}, z.core.$strip>;
+export declare const WorkLoopUpdateRequestSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    assigneeAgentId: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        urgent: "urgent";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        paused: "paused";
+        archived: "archived";
+    }>>;
+    concurrencyPolicy: z.ZodOptional<z.ZodEnum<{
+        coalesce_if_active: "coalesce_if_active";
+        skip_if_active: "skip_if_active";
+        always_enqueue: "always_enqueue";
+    }>>;
+    catchUpPolicy: z.ZodOptional<z.ZodEnum<{
+        skip_missed: "skip_missed";
+        enqueue_missed_with_cap: "enqueue_missed_with_cap";
+    }>>;
+    parentIssueId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    goalIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    projectId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const WorkLoopTriggerCronCreateSchema: z.ZodObject<{
+    mode: z.ZodLiteral<"cron">;
+    cronExpression: z.ZodString;
+    timezone: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const WorkLoopTriggerPresetCreateSchema: z.ZodObject<{
+    mode: z.ZodLiteral<"preset">;
+    preset: z.ZodEnum<{
+        daily: "daily";
+        weekly: "weekly";
+    }>;
+    hour24: z.ZodNumber;
+    minute: z.ZodNumber;
+    dayOfWeek: z.ZodOptional<z.ZodNumber>;
+    timezone: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const WorkLoopTriggerCreateRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"cron">;
+    cronExpression: z.ZodString;
+    timezone: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    mode: z.ZodLiteral<"preset">;
+    preset: z.ZodEnum<{
+        daily: "daily";
+        weekly: "weekly";
+    }>;
+    hour24: z.ZodNumber;
+    minute: z.ZodNumber;
+    dayOfWeek: z.ZodOptional<z.ZodNumber>;
+    timezone: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>], "mode">;
+export declare const WorkLoopTriggerUpdateRequestSchema: z.ZodObject<{
+    cronExpression: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
 export declare const IssueAttachmentSchema: z.ZodObject<{
     id: z.ZodString;
     companyId: z.ZodString;
@@ -216,6 +397,8 @@ export declare const IssueDetailSchema: z.ZodObject<{
     assigneeAgentId: z.ZodNullable<z.ZodString>;
     labels: z.ZodDefault<z.ZodArray<z.ZodString>>;
     tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    loopId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    loopRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     attachments: z.ZodArray<z.ZodObject<{
@@ -405,6 +588,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";
@@ -414,6 +598,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";
     }>>>;
@@ -532,6 +717,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";
@@ -541,6 +727,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";
         }>>>;
@@ -692,6 +879,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";
@@ -701,6 +889,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";
             }>>>;
@@ -852,6 +1041,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";
@@ -861,6 +1051,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";
             }>>>;
@@ -1010,6 +1201,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";
@@ -1019,6 +1211,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";
             }>>>;
@@ -1219,6 +1412,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";
@@ -1228,6 +1422,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";
                 }>>>;
@@ -1381,6 +1576,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";
@@ -1390,6 +1586,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";
                     }>>>;
@@ -1520,6 +1717,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";
@@ -1529,6 +1727,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";
             }>>>;
@@ -1634,6 +1833,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";
 }>;
@@ -1832,6 +2032,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";
     }>;
@@ -1909,6 +2110,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";
         }>;
@@ -2165,6 +2367,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";
@@ -2174,6 +2377,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";
     }>;
@@ -2209,10 +2413,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<{
@@ -2257,6 +2463,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";
@@ -2266,6 +2473,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";
     }>>;
@@ -2322,6 +2530,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";
@@ -2331,6 +2540,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";
     }>;
@@ -2828,6 +3038,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";
     }>>;
@@ -2875,6 +3086,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";
         }>>;
@@ -2921,6 +3133,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";
         }>>;
@@ -3214,6 +3427,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";
             }>>;
@@ -3260,6 +3474,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";
             }>>;
@@ -3641,6 +3856,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";
             }>>;
@@ -3687,6 +3903,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";
             }>>;
@@ -4070,6 +4287,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";
             }>>;
@@ -4116,6 +4334,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";
             }>>;
@@ -4386,6 +4605,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";
     }>;
@@ -4668,6 +4888,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.29",
+  "version": "0.1.31",
   "license": "MIT",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "dependencies": {
-    "bopodev-contracts": "0.1.29"
+    "bopodev-contracts": "0.1.31"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json --emitDeclarationOnly",

package/src/adapters.ts

@@ -686,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",
@@ -708,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" },
@@ -771,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") {
@@ -900,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"],
@@ -2700,9 +2712,43 @@ function composeBootstrapPreamble(context: HeartbeatContext): string {
   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 preamble = composeBootstrapPreamble(context);
-  return `${preamble}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 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}
 `;
@@ -2844,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.",
@@ -2885,7 +2933,7 @@ 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

@@ -85,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;
+  }>;
 }
 
 /**