@kodax-ai/kodax 0.7.40 → 0.7.41

package/dist/types-chunks/types.d-C5mHR87z.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @kodax-ai/agent/messaging — Message queue types
+ *
+ * FEATURE_115 (v0.7.36): agentId-scoped 2-tier priority queue infrastructure.
+ *
+ * Per ADR-021: messaging is a generic agent-platform primitive (not coding-
+ * specific). Downstream consumers:
+ *   - @kodax-ai/coding runner-driven mid-turn drain
+ *   - @kodax-ai/repl InkREPL ESC soft-pause + text injection (FEATURE_111 absorbed)
+ *   - subagent task-notification routing (FEATURE_155 idle-yield wakeup)
+ *
+ * Phase 0.6 study (`c:/tmp/claude-code-actual-usage.md`): Claude Code's
+ * `'now'` priority has zero production usage; KodaX simplifies to 2 tiers.
+ */
+type MessagePriority = 'user' | 'background';
+type MessageMode = 'prompt' | 'task-notification' | 'system-reminder';
+interface QueuedMessage {
+    /** Stable id for tracing / dedup. Format: `msg-<sequence>`. */
+    readonly id: string;
+    readonly priority: MessagePriority;
+    /**
+     * Routing key:
+     *   undefined = main thread / coordinator agent
+     *   'agent-id-XYZ' = subagent / specific consumer
+     *
+     * Drain consumers MUST filter by agentId match — undefined matches only
+     * undefined-agentId messages, not "any agent".
+     */
+    readonly agentId?: string;
+    readonly mode: MessageMode;
+    readonly content: string;
+    /** Wall-clock timestamp (`Date.now()`) for tracing only — not used for ordering. */
+    readonly enqueuedAt: number;
+}
+interface DequeueFilter {
+    /**
+     * Only return messages with this agentId.
+     * undefined matches messages with no agentId (main-thread messages only).
+     */
+    readonly agentId?: string;
+    /**
+     * Highest priority level included in the drain.
+     *   'user'       → only user priority drained, background stays queued
+     *   'background' → both user + background drained (Sleep-gated case)
+     */
+    readonly maxPriority: MessagePriority;
+    /**
+     * Optional cap on number of messages drained in this call.
+     * Defaults to unlimited (drains all matching).
+     */
+    readonly limit?: number;
+    /**
+     * FEATURE_159 (v0.7.40) — optional mode filter. Lets REPL split the
+     * single queue into mode-typed views (e.g. `mode:'prompt'` for user
+     * input vs `mode:'task-notification'` for child completion banners)
+     * without separate queues. When omitted, all modes match.
+     */
+    readonly mode?: MessageMode;
+    /**
+     * FEATURE_159 (v0.7.40) — optional precise-id filter. Single-message
+     * targeted removal — drives Esc-pop-this-uuid in REPL. When set, all
+     * other filters still apply (agentId / priority / mode mismatches still
+     * skip the message), so callers can't accidentally remove a message
+     * outside their scope.
+     */
+    readonly id?: string;
+    /**
+     * FEATURE_159 (v0.7.40) — optional escape-hatch predicate, AND-ed with
+     * the structured filters. Lets SDK consumers express conditions the
+     * typed fields don't cover (e.g. timestamp ranges, content-match) without
+     * forcing every new use case to extend `DequeueFilter`. KodaX-internal
+     * code should prefer the typed fields for readability; this is the
+     * "data-driven main path + predicate escape" pattern.
+     *
+     * Evaluated AFTER the typed filters succeed — so a `predicate` that
+     * inspects `message.content` never runs on messages outside the
+     * caller's `agentId` / `mode` / `id` scope.
+     */
+    readonly predicate?: (message: QueuedMessage) => boolean;
+}
+/**
+ * FEATURE_159 (v0.7.40) — structured queue event emitted to subscribers.
+ *
+ * Replaces the prior `() => void` bare-notify signal. Carries the kind +
+ * affected messages so SDK observability consumers (logging, tracing,
+ * metrics) can react per-event without re-diffing snapshots.
+ *
+ * Event granularity rules:
+ *   - `enqueued` fires ONCE per `enqueue()` call (always 1 message).
+ *   - `dequeued` fires ONCE per `dequeue()` call that removed ≥1 message,
+ *     carrying ALL drained messages in priority+FIFO order. No-op drains
+ *     (filter matched nothing) fire no event — quiet by design so the
+ *     `waitForWakeEvent` 100ms poll doesn't spam idle subscribers.
+ *   - `cleared` fires ONCE per `clear()` call that removed ≥1 message,
+ *     carrying the pre-clear messages. Empty-queue clear fires nothing.
+ *
+ * The `useSyncExternalStore` React hook ignores the event payload (it
+ * only needs the change signal); SDK / tracer consumers read the event.
+ */
+type QueueEvent = {
+    readonly kind: 'enqueued';
+    readonly message: QueuedMessage;
+} | {
+    readonly kind: 'dequeued';
+    readonly messages: readonly QueuedMessage[];
+} | {
+    readonly kind: 'cleared';
+    readonly messages: readonly QueuedMessage[];
+};
+/** FEATURE_159 — `MessageQueue.subscribe` listener signature. */
+type QueueEventListener = (event: QueueEvent) => void;
+interface EnqueueInput {
+    readonly priority: MessagePriority;
+    readonly mode: MessageMode;
+    readonly content: string;
+    readonly agentId?: string;
+}
+
+export type { DequeueFilter as D, EnqueueInput as E, MessageMode as M, QueueEventListener as Q, MessagePriority as a, QueuedMessage as b };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodax-ai/kodax",
-  "version": "0.7.40",
+  "version": "0.7.41",
   "description": "极致轻量化 Coding Agent - TypeScript 实现，支持 12 个 LLM 提供商，可发布为免 Node 单文件二进制",
   "type": "module",
   "workspaces": [
@@ -39,7 +39,8 @@
     "./package.json": "./package.json"
   },
   "scripts": {
-    "build": "npm run build:packages && npm run build:bundle && tsc --emitDeclarationOnly",
+    "build": "npm run build:packages && npm run build:bundle && npm run build:dts",
+    "build:dts": "node scripts/build-dts.mjs",
     "build:packages": "tsc -b tsconfig.build.json && npm run copy:builtin -w @kodax-ai/skills",
     "build:bundle": "node scripts/build-bundle.mjs",
     "dev": "node --max-old-space-size=4096 --require ./scripts/production-env.cjs --import tsx src/kodax_cli.ts",
@@ -56,6 +57,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:eval": "vitest run -c vitest.eval.config.ts",
+    "bench:perf": "tsx benchmark/perf/repl-render-perf.bench.ts",
+    "bench:perf:e2e": "tsx benchmark/perf/repl-render-engine-e2e.bench.ts",
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "clean:packages": "npm run clean --workspaces"
   },
@@ -87,11 +90,11 @@
     "glob": "^11.0.1",
     "iconv-lite": "^0.6.3",
     "indent-string": "^5.0.0",
-    "jimp": "^1.6.0",
     "ink": "^6.7.0",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
     "is-in-ci": "^2.0.0",
+    "jimp": "^1.6.0",
     "js-tiktoken": "^1.0.12",
     "openai": "^6.32.0",
     "partial-json": "^0.1.7",
@@ -120,6 +123,8 @@
     "@vitest/coverage-v8": "^3.2.4",
     "esbuild": "^0.27.7",
     "ink-testing-library": "^4.0.0",
+    "rollup": "^4.60.4",
+    "rollup-plugin-dts": "^6.4.1",
     "vitest": "^3.2.4"
   },
   "engines": {

package/dist/acp_events.d.ts

@@ -1,109 +0,0 @@
-export type AcpRuntimeEvent = {
-    type: 'server_attached';
-    agent: string;
-    version: string;
-    provider: string;
-    model: string;
-    cwd: string;
-    permissionMode: string;
-    reasoningMode: string;
-    thinking: boolean;
-    fixedCwd: boolean;
-} | {
-    type: 'connection_closed';
-    activeSessions: number;
-} | {
-    type: 'initialize_completed';
-    protocolVersion: number;
-} | {
-    type: 'session_created';
-    sessionId: string;
-    cwd: string;
-    permissionMode: string;
-    mcpServers: number;
-} | {
-    type: 'session_mode_changed';
-    sessionId: string;
-    from: string;
-    to: string;
-} | {
-    type: 'prompt_skipped';
-    sessionId: string;
-} | {
-    type: 'prompt_started';
-    sessionId: string;
-    messageId: string | null;
-    chars: number;
-    cwd: string;
-    queueDelayMs: number;
-} | {
-    type: 'prompt_preview';
-    sessionId: string;
-    prompt: string;
-} | {
-    type: 'prompt_finished';
-    sessionId: string;
-    stopReason: 'cancelled' | 'end_turn';
-    interrupted: boolean;
-    durationMs: number;
-} | {
-    type: 'prompt_cancelled';
-    sessionId: string;
-    durationMs: number;
-} | {
-    type: 'prompt_failed';
-    sessionId: string;
-    durationMs: number;
-    error: string;
-} | {
-    type: 'cancel_requested';
-    sessionId: string;
-    active: boolean;
-} | {
-    type: 'tool_permission_evaluated';
-    sessionId: string;
-    tool: string;
-    toolId: string | null;
-    permissionMode: string;
-} | {
-    type: 'tool_permission_resolved';
-    sessionId: string;
-    tool: string;
-    toolId: string | null;
-    outcome: 'auto_allowed_read_only_bash' | 'auto_allowed_remembered' | 'blocked_plan_mode' | 'auto_allowed_plan_mode' | 'auto_allowed_policy' | 'request_failed_disconnected' | 'request_failed_incomplete' | 'request_dismissed' | 'request_rejected' | 'request_granted';
-    remember?: boolean;
-} | {
-    type: 'permission_requested';
-    sessionId: string;
-    tool: string;
-    toolId: string;
-} | {
-    type: 'notification_failed';
-    sessionId: string;
-    label: string;
-    error: string;
-} | {
-    type: 'repo_intelligence_trace';
-    sessionId: string;
-    stage: 'routing' | 'preturn' | 'module' | 'impact' | 'task-snapshot';
-    summary: string;
-    mode?: string;
-    engine?: string;
-    bridge?: string;
-    status?: string;
-    daemonLatencyMs?: number;
-    cliLatencyMs?: number;
-    cacheHit?: boolean;
-    capsuleEstimatedTokens?: number;
-};
-export interface AcpEventSink {
-    handleEvent(event: AcpRuntimeEvent): void;
-}
-export interface AcpEventEmitterOptions {
-    sinks?: AcpEventSink[];
-}
-export declare class AcpEventEmitter {
-    private readonly sinks;
-    constructor(options?: AcpEventEmitterOptions);
-    emit(event: AcpRuntimeEvent): void;
-}

package/dist/acp_logger.d.ts

@@ -1,20 +0,0 @@
-import type { AcpEventSink, AcpRuntimeEvent } from './acp_events.js';
-export declare const ACP_LOG_LEVELS: readonly ["off", "error", "info", "debug"];
-export type AcpLogLevel = (typeof ACP_LOG_LEVELS)[number];
-export declare function resolveAcpLogLevel(value: string | undefined, fallback?: AcpLogLevel): AcpLogLevel;
-export interface AcpLoggerOptions {
-    level?: AcpLogLevel;
-    sink?: (line: string) => void;
-}
-type AcpLogFields = Record<string, string | number | boolean | null | undefined>;
-export declare class AcpLogger implements AcpEventSink {
-    private readonly level;
-    private readonly sink;
-    constructor(options?: AcpLoggerOptions);
-    handleEvent(event: AcpRuntimeEvent): void;
-    error(message: string, fields?: AcpLogFields): void;
-    info(message: string, fields?: AcpLogFields): void;
-    debug(message: string, fields?: AcpLogFields): void;
-    private log;
-}
-export {};

package/dist/acp_server.d.ts

@@ -1,92 +0,0 @@
-import { AgentSideConnection, type Agent, type InitializeRequest, type InitializeResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type SetSessionModeRequest, type SetSessionModeResponse } from '@agentclientprotocol/sdk';
-import { type KodaXReasoningMode } from '@kodax-ai/coding';
-import { FileSessionStorage } from '@kodax-ai/repl';
-import { type AcpLogLevel } from './acp_logger.js';
-import { type AcpEventSink } from './acp_events.js';
-/**
- * Permission mode ids exposed to ACP clients. These are wire-protocol values
- * advertised in `SessionMode.id`, so the set is intentionally narrower than
- * the canonical `PermissionMode` from `@kodax-ai/repl`.
- *
- * Why `'auto'` (canonical FEATURE_092 v0.7.33) is **not** here:
- *
- *   1. ACP's auto-mode classifier path requires an interactive `askUser`
- *      surface (the readline confirm prompt or Ink confirm dialog).
- *      `KodaXAcpServer` runs out-of-process and routes confirmations through
- *      `connection.requestPermission` — a different protocol that has no
- *      structural place for the classifier-escalate `<reason>` payload.
- *   2. ACP clients that want auto-style behavior continue to use the
- *      legacy alias `'auto-in-project'`, which goes through
- *      `evaluateToolPermission` → `requestPermissionFromClient` (no LLM
- *      classifier, identical pre-v0.7.33 semantics).
- *   3. Once an ACP-native classifier-escalate channel lands, `'auto'` will
- *      be added here as a third id without breaking existing clients.
- */
-export declare const ACP_PERMISSION_MODE_IDS: readonly ["plan", "accept-edits", "auto-in-project"];
-export type AcpPermissionMode = (typeof ACP_PERMISSION_MODE_IDS)[number];
-export interface KodaXAcpServerOptions {
-    /** Provider name forwarded to the coding runtime. */
-    provider?: string;
-    /** Optional model override forwarded to the coding runtime. */
-    model?: string;
-    thinking?: boolean;
-    reasoningMode?: KodaXReasoningMode;
-    /**
-     * Default session working directory. When explicitly set on the server, it
-     * becomes the fixed execution cwd for all ACP sessions and overrides any
-     * client-provided session cwd.
-     */
-    cwd?: string;
-    permissionMode?: AcpPermissionMode;
-    logLevel?: AcpLogLevel;
-    /** Additional sinks that receive structured ACP runtime events. */
-    eventSinks?: AcpEventSink[];
-    agentName?: string;
-    agentVersion?: string;
-    storage?: FileSessionStorage;
-}
-export declare class KodaXAcpServer implements Agent {
-    private readonly provider;
-    private readonly model?;
-    private readonly thinking;
-    private readonly reasoningMode;
-    private readonly defaultPermissionMode;
-    private readonly defaultCwd;
-    private readonly hasFixedCwd;
-    private readonly agentName;
-    private readonly agentVersion;
-    private readonly storage;
-    private readonly events;
-    /**
-     * FEATURE_153 (v0.7.38) — LLM-backed bash prefix extractor used by
-     * `isToolCallAllowed` to match allowlist patterns against the extracted
-     * safe prefix instead of naive `command.startsWith`. Server-scoped (one
-     * per `KodaXAcpServer` instance) so the LRU cache is shared across all
-     * sessions, mirroring the REPL's session-scoped pattern.
-     */
-    private readonly bashPrefixExtractor;
-    private connection;
-    private readonly sessions;
-    private promptQueue;
-    private extensionRuntime?;
-    private extensionRuntimeReady?;
-    constructor(options?: KodaXAcpServerOptions);
-    attach(input: ReadableStream<Uint8Array>, output: WritableStream<Uint8Array>): AgentSideConnection;
-    waitForClose(): Promise<void>;
-    initialize(_params: InitializeRequest): Promise<InitializeResponse>;
-    newSession(params: NewSessionRequest): Promise<NewSessionResponse>;
-    authenticate(): Promise<void>;
-    setSessionMode(params: SetSessionModeRequest): Promise<SetSessionModeResponse>;
-    prompt(params: PromptRequest): Promise<PromptResponse>;
-    cancel(params: {
-        sessionId: string;
-    }): Promise<void>;
-    private requireSession;
-    private buildKodaXOptions;
-    private evaluateToolPermission;
-    private requestPermissionFromClient;
-    private sendTextChunk;
-    private sendSessionUpdate;
-    private dispatchNotification;
-}
-export declare function runAcpServer(options?: KodaXAcpServerOptions): Promise<void>;