@a1hvdy/cc-openclaw 0.8.0 → 0.9.0

package/dist/src/types/session.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Cluster A — Session boundary types.
+ *
+ * Re-exports the session vocabulary already established in the root
+ * `src/types.ts` module. New aliases (`SessionStartConfig`, `SessionMeta`)
+ * preview Cluster B's `SessionService` boundary without yet introducing
+ * a new shape — they're typed wrappers over today's `SessionConfig` /
+ * `ActiveSession`.
+ *
+ * `SessionName` is the branded type that Cluster D's `SessionRegistry`
+ * will use to enforce the `'openai-'` prefix routing discriminant
+ * (cwd-patch.ts:489 gates CWD redirect, tools restoration, CLAUDE.md
+ * injection on this prefix).
+ *
+ * NOT consumed yet — Cluster A first commit establishes the vocabulary.
+ */
+export type { SessionConfig as SessionStartConfig, SessionStats, ActiveSession, SessionInfo, SessionSendOptions, StreamCallbacks, StreamEvent, SendResult, SendOptions, TurnResult, CostBreakdown, ISession, EngineType, PermissionMode, EffortLevel, PluginConfig, HookConfig, CustomEngineConfig, } from '../types.js';
+/**
+ * Branded session-name type. Prevents raw string from being passed where
+ * the `'openai-'` prefix is load-bearing. Use the constructors below to
+ * mint or strip the prefix — never construct directly.
+ */
+export type SessionName = string & {
+    readonly __brand: 'SessionName';
+};
+export declare const sessionNameFromKey: (key: string) => SessionName;
+export declare const isOpenAiBridgeName: (name: SessionName) => boolean;
+export declare const stripOpenAiPrefix: (name: SessionName) => string;
+/**
+ * Cluster B/D will fold this into `SessionRegistry.SessionEntry`. For
+ * Cluster A it's a typed preview — the shape Cluster D will persist,
+ * declared here so other clusters can compile against the contract.
+ */
+export interface SessionMeta {
+    readonly name: SessionName;
+    readonly claudeSessionId: string | null;
+    readonly pid: number | null;
+    readonly cachedSysPromptHash: string;
+    readonly skipPersistence: boolean;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+}
+/**
+ * Input shape Cluster B's `SessionService.send()` accepts.
+ * Today's call sites pass either a string or an array of content blocks;
+ * this interface preserves both without yet committing to a tighter shape.
+ */
+export type SendInput = string | ReadonlyArray<unknown>;

package/dist/src/types/session.js

@@ -0,0 +1,20 @@
+/**
+ * Cluster A — Session boundary types.
+ *
+ * Re-exports the session vocabulary already established in the root
+ * `src/types.ts` module. New aliases (`SessionStartConfig`, `SessionMeta`)
+ * preview Cluster B's `SessionService` boundary without yet introducing
+ * a new shape — they're typed wrappers over today's `SessionConfig` /
+ * `ActiveSession`.
+ *
+ * `SessionName` is the branded type that Cluster D's `SessionRegistry`
+ * will use to enforce the `'openai-'` prefix routing discriminant
+ * (cwd-patch.ts:489 gates CWD redirect, tools restoration, CLAUDE.md
+ * injection on this prefix).
+ *
+ * NOT consumed yet — Cluster A first commit establishes the vocabulary.
+ */
+export const sessionNameFromKey = (key) => `openai-${key}`;
+export const isOpenAiBridgeName = (name) => name.startsWith('openai-');
+export const stripOpenAiPrefix = (name) => name.replace(/^openai-/, '');
+//# sourceMappingURL=session.js.map

package/dist/src/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/types/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA8BH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAe,EAAE,CAC7D,UAAU,GAAG,EAAiB,CAAC;AAEjC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAiB,EAAW,EAAE,CAC/D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAE7B,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAiB,EAAU,EAAE,CAC7D,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC"}

package/dist/src/types/sse.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Cluster A — SSE wire-format types.
+ *
+ * Re-exports the SSE types currently inline in `openai-compat.ts` and the
+ * Anthropic event types from `cli-stream-parser.ts` under a single import
+ * surface. Cluster B's `sse-translator.ts` already lives at
+ * `src/openai-compat/sse-translator.ts` — this module is its typed contract.
+ *
+ * NOT consumed yet — Cluster A first commit establishes the vocabulary.
+ */
+export type { OpenAIChatCompletionChunk as SseChunk, OpenAIToolCall, } from '../openai-compat/openai-compat.js';
+export type { AnthropicEvent, AnthropicMessage, MessageUsage, MessageDeltaBody, ContentBlockStart, ContentBlockDelta, ParsedEvent, CliStreamParser, } from '../openai-compat/cli-stream-parser.js';
+/**
+ * OpenAI `finish_reason` values cc-openclaw emits after mapping from
+ * Anthropic `stop_reason`:
+ *   end_turn / stop_sequence → 'stop'
+ *   tool_use                 → 'tool_calls'
+ *   max_tokens               → 'length'
+ *   (cancelled / abort)      → null  (no finish_reason chunk)
+ */
+export type FinishReason = 'stop' | 'tool_calls' | 'length' | null;
+/**
+ * One delta in an OpenAI streaming chunk. Cluster B will tighten this when
+ * `sse-translator.ts` is extracted into the typed boundary.
+ */
+export interface OpenAIDelta {
+    readonly role?: 'assistant' | 'system' | 'user' | 'tool';
+    readonly content?: string;
+    readonly tool_calls?: ReadonlyArray<{
+        readonly index: number;
+        readonly id?: string;
+        readonly type?: 'function';
+        readonly function?: {
+            readonly name?: string;
+            readonly arguments?: string;
+        };
+    }>;
+}

package/dist/src/types/sse.js

@@ -0,0 +1,12 @@
+/**
+ * Cluster A — SSE wire-format types.
+ *
+ * Re-exports the SSE types currently inline in `openai-compat.ts` and the
+ * Anthropic event types from `cli-stream-parser.ts` under a single import
+ * surface. Cluster B's `sse-translator.ts` already lives at
+ * `src/openai-compat/sse-translator.ts` — this module is its typed contract.
+ *
+ * NOT consumed yet — Cluster A first commit establishes the vocabulary.
+ */
+export {};
+//# sourceMappingURL=sse.js.map

package/dist/src/types/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../../src/types/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/src/types/tool-bridge.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Cluster A — Tool bridge contract.
+ *
+ * Declares the interface Cluster B's three tool-mode strategies will
+ * implement (`EmbeddedToolsBridge`, `PerMessageToolsBridge`,
+ * `NativeToolStreamBridge`). Lives in `src/types/` — pure type
+ * declaration, no runtime code, zero implementation yet.
+ *
+ * The mode → bridge selection in Cluster B is one-way: `bridges/factory.ts`
+ * imports from this module; `system-prompt-builder.ts` (the other
+ * potentially-circular dependency) accepts a `ToolMode` arg from the
+ * bridge rather than importing the factory. See PRP §11 Decision Log.
+ *
+ * NOT consumed yet — Cluster A first commit establishes the vocabulary.
+ */
+import type { OpenAIToolCall } from './route.js';
+import type { OpenAIDelta } from './sse.js';
+/**
+ * Three tool-handling modes documented in ARCHITECTURE.md §5.3:
+ *
+ * - Embedded     — default. Tools embedded in session system prompt at
+ *                  create-time; NOT re-injected per turn; cacheable.
+ * - PerMessage   — legacy `OPENAI_COMPAT_TOOLS_PER_MESSAGE=1`. Tool block
+ *                  prepended to every user message; defeats prompt caching;
+ *                  allows mutating tool list mid-session.
+ * - NativeStream — `CC_OPENCLAW_TOOL_STREAM=1`. Tools forwarded as
+ *                  `--tools` allowlist; native `tool_use` events flow
+ *                  through; SSE translator emits inline `delta.tool_calls`.
+ */
+export declare enum ToolMode {
+    Embedded = "embedded",
+    PerMessage = "per-message",
+    NativeStream = "native-stream"
+}
+/**
+ * The tool definition shape OpenClaw's `createOpenClawCodingTools` produces
+ * and that callers send in `request.tools`. Shape mirrors the OpenAI tool
+ * definition. Cluster B will tighten when bridge implementations land.
+ */
+export interface ToolDefinition {
+    readonly type: 'function';
+    readonly function: {
+        readonly name: string;
+        readonly description?: string;
+        readonly parameters?: Record<string, unknown>;
+    };
+}
+/**
+ * Result of translating a single Anthropic `tool_use` event from the
+ * Claude CLI stream into an OpenAI streaming chunk delta. `null` means
+ * the bridge consumed the event but emitted nothing (e.g. mid-block
+ * input_json_delta accumulation).
+ */
+export type TranslatedToolUseDelta = OpenAIDelta | null;
+/**
+ * The contract every tool-mode bridge must satisfy. Cluster B's three
+ * strategy classes live at `src/openai-compat/bridges/{embedded-tools,
+ * per-message,native-stream}.ts`. Each is constructed once per route
+ * request and discarded after the response is written.
+ */
+export interface IToolBridge {
+    readonly mode: ToolMode;
+    /**
+     * Build the system-prompt fragment that advertises the tool list to
+     * the model. Pure function — no I/O. Empty string when the bridge
+     * does not embed tools in the prompt (NativeStream).
+     */
+    buildToolPreamble(tools: ReadonlyArray<ToolDefinition> | undefined): string;
+    /**
+     * Translate one parsed Anthropic event into an OpenAI delta if it
+     * represents a tool_use boundary. Returns `null` for events the
+     * bridge does not surface as tool_calls deltas.
+     */
+    translateToolUse(event: unknown): TranslatedToolUseDelta;
+    /**
+     * Serialize an OpenAI tool_call result back into the format the
+     * bridge sends to Claude CLI on the next turn. Embedded + PerMessage
+     * use `<tool_result>` XML; NativeStream uses native blocks.
+     */
+    serializeToolResult(call: OpenAIToolCall, result: string): string;
+}

package/dist/src/types/tool-bridge.js

@@ -0,0 +1,34 @@
+/**
+ * Cluster A — Tool bridge contract.
+ *
+ * Declares the interface Cluster B's three tool-mode strategies will
+ * implement (`EmbeddedToolsBridge`, `PerMessageToolsBridge`,
+ * `NativeToolStreamBridge`). Lives in `src/types/` — pure type
+ * declaration, no runtime code, zero implementation yet.
+ *
+ * The mode → bridge selection in Cluster B is one-way: `bridges/factory.ts`
+ * imports from this module; `system-prompt-builder.ts` (the other
+ * potentially-circular dependency) accepts a `ToolMode` arg from the
+ * bridge rather than importing the factory. See PRP §11 Decision Log.
+ *
+ * NOT consumed yet — Cluster A first commit establishes the vocabulary.
+ */
+/**
+ * Three tool-handling modes documented in ARCHITECTURE.md §5.3:
+ *
+ * - Embedded     — default. Tools embedded in session system prompt at
+ *                  create-time; NOT re-injected per turn; cacheable.
+ * - PerMessage   — legacy `OPENAI_COMPAT_TOOLS_PER_MESSAGE=1`. Tool block
+ *                  prepended to every user message; defeats prompt caching;
+ *                  allows mutating tool list mid-session.
+ * - NativeStream — `CC_OPENCLAW_TOOL_STREAM=1`. Tools forwarded as
+ *                  `--tools` allowlist; native `tool_use` events flow
+ *                  through; SSE translator emits inline `delta.tool_calls`.
+ */
+export var ToolMode;
+(function (ToolMode) {
+    ToolMode["Embedded"] = "embedded";
+    ToolMode["PerMessage"] = "per-message";
+    ToolMode["NativeStream"] = "native-stream";
+})(ToolMode || (ToolMode = {}));
+//# sourceMappingURL=tool-bridge.js.map

package/dist/src/types/tool-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-bridge.js","sourceRoot":"","sources":["../../../src/types/tool-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,iCAAqB,CAAA;IACrB,sCAA0B,CAAA;IAC1B,0CAA8B,CAAA;AAChC,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB"}