qlogicagent 0.1.0

package/dist/agent/types.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Pure agent types — zero I/O framework dependencies.
+ *
+ * These types define the contract between:
+ *   - CLI stdio layer ↔ Agent class
+ *   - Agent class ↔ LLM Provider
+ *   - Agent class ↔ Tool loop
+ *
+ * Ported from Hub semantic-turn-shared.ts / semantic-turn-tools.ts,
+ * with Hub infrastructure (WS/PG/Redis) replaced by DI interfaces.
+ *
+ * No imports from express/pg/ioredis/ws.
+ */
+import type { SkillInstruction } from "../orchestration/index.js";
+import type { HookRegistry } from "../contracts/hooks.js";
+export type ChatMessageRole = "system" | "user" | "assistant" | "tool";
+export interface ChatMessage {
+    role: ChatMessageRole;
+    content: string | null;
+    /** For assistant messages with tool calls */
+    tool_calls?: ToolCallMessage[];
+    /** For tool result messages */
+    tool_call_id?: string;
+    /** For tool result messages — tool name */
+    name?: string;
+}
+export interface ToolCallMessage {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ToolDefinition {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters?: Record<string, unknown>;
+    };
+    /** Tool scheduling metadata from host manifest (optional) */
+    meta?: {
+        serialOnly?: boolean;
+        parallelSafe?: boolean;
+        /** If true, host should request user approval before execution (CC PreToolUse parity) */
+        requiresApproval?: boolean;
+        /** Tool is read-only / safe — skip approval even in strict mode */
+        isReadOnly?: boolean;
+        /** Tool can cause irreversible side-effects — force approval in default mode */
+        isDangerous?: boolean;
+    };
+}
+export interface TokenUsage {
+    prompt: number;
+    completion: number;
+    /** Reasoning tokens (for models like o1/DeepSeek-R1) */
+    reasoning?: number;
+}
+export interface TurnRequest {
+    turnId: string;
+    sessionId: string;
+    messages: ChatMessage[];
+    tools: ToolDefinition[];
+    systemPrompt?: string;
+    config?: TurnConfig;
+}
+export interface TurnConfig {
+    /** LLM provider id, e.g. "deepseek" */
+    provider?: string;
+    /** Model id, e.g. "deepseek-chat" */
+    model?: string;
+    /** User API key */
+    apiKey?: string;
+    /** Optional base URL override */
+    baseUrl?: string;
+    /** Max tool-call rounds per turn (default 25, max 100) */
+    maxRounds?: number;
+    /** Temperature override */
+    temperature?: number;
+    /** Context window size in tokens (for turn-loop-guard budget checks) */
+    contextWindowTokens?: number;
+    /** Max output tokens for current model */
+    maxOutputTokens?: number;
+    /** Model's absolute max output tokens (for escalation ceiling) */
+    modelMaxOutputTokens?: number;
+    /** Tool choice strategy: "auto" (default), "none", "required" */
+    toolChoice?: "auto" | "none" | "required";
+    /** Parent sidechain depth (0 = top-level, default 0) */
+    parentDepth?: number;
+}
+export type TurnEvent = {
+    type: "start";
+    turnId: string;
+} | {
+    type: "delta";
+    turnId: string;
+    text: string;
+} | {
+    type: "tool_call";
+    turnId: string;
+    callId: string;
+    name: string;
+    arguments: string;
+} | {
+    type: "end";
+    turnId: string;
+    content: string;
+    usage?: TokenUsage;
+    model?: string;
+    provider?: string;
+} | {
+    type: "error";
+    turnId: string;
+    error: string;
+    code?: string;
+} | {
+    type: "skill_instruction";
+    turnId: string;
+    instruction: SkillInstruction;
+} | {
+    type: "tool_result";
+    turnId: string;
+    callId: string;
+    name: string;
+    ok: boolean;
+    error?: string;
+} | {
+    type: "sidechain_started";
+    turnId: string;
+    depth: number;
+    role: "orchestrator" | "leaf";
+} | {
+    type: "sidechain_completed";
+    turnId: string;
+    depth: number;
+    toolCallCount: number;
+} | {
+    type: "tool_blocked";
+    turnId: string;
+    callId: string;
+    name: string;
+    reason: string;
+} | {
+    type: "recovery";
+    turnId: string;
+    action: string;
+    detail?: string;
+} | {
+    type: "plan_update";
+    turnId: string;
+    slug: string;
+    content: string;
+};
+/**
+ * ToolInvoker: request tool execution from the host process (Gateway).
+ * In CLI mode this sends a JSON-RPC notification over stdio and waits for result.
+ */
+export interface ToolInvoker {
+    invoke(turnId: string, name: string, args: string, signal?: AbortSignal): Promise<{
+        result: string;
+        error?: string;
+    }>;
+}
+/**
+ * AgentLogger: structured logging interface.
+ * In CLI mode this writes to stderr; in Hub mode this uses pino.
+ */
+export interface AgentLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+}
+export type { HookRegistry };
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"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"}

package/dist/agent/types.js

@@ -0,0 +1,15 @@
+/**
+ * Pure agent types — zero I/O framework dependencies.
+ *
+ * These types define the contract between:
+ *   - CLI stdio layer ↔ Agent class
+ *   - Agent class ↔ LLM Provider
+ *   - Agent class ↔ Tool loop
+ *
+ * Ported from Hub semantic-turn-shared.ts / semantic-turn-tools.ts,
+ * with Hub infrastructure (WS/PG/Redis) replaced by DI interfaces.
+ *
+ * No imports from express/pg/ioredis/ws.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

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

package/dist/cli/main.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * qlogicagent CLI — Agent subprocess entry point.
+ *
+ * Communicates with openclaw Gateway via JSON-RPC over stdio.
+ * All log/debug output goes to stderr (never pollutes the stdio protocol).
+ *
+ * Usage:
+ *   qlogicagent [--verbose]
+ */
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/cli/main.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * qlogicagent CLI — Agent subprocess entry point.
+ *
+ * Communicates with openclaw Gateway via JSON-RPC over stdio.
+ * All log/debug output goes to stderr (never pollutes the stdio protocol).
+ *
+ * Usage:
+ *   qlogicagent [--verbose]
+ */
+import { StdioServer } from "./stdio-server.js";
+import { parseCliArgs } from "../config/config.js";
+const config = parseCliArgs(process.argv);
+const server = new StdioServer({ verbose: config.verbose });
+// Graceful shutdown
+const shutdown = () => {
+    server.stop();
+    process.exit(0);
+};
+process.on("SIGTERM", shutdown);
+process.on("SIGINT", shutdown);
+// Start the JSON-RPC stdio server
+server.start();
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;AAE5D,oBAAoB;AACpB,MAAM,QAAQ,GAAG,GAAG,EAAE;IACrB,MAAM,CAAC,IAAI,EAAE,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC;AAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAE/B,kCAAkC;AAClC,MAAM,CAAC,KAAK,EAAE,CAAC"}

package/dist/cli/stdio-server.d.ts

@@ -0,0 +1,46 @@
+/**
+ * StdioServer — JSON-RPC 2.0 over stdio protocol handler.
+ *
+ * Reads line-delimited JSON from stdin, dispatches to handlers,
+ * writes JSON-RPC responses/notifications to stdout.
+ * All log output goes to stderr.
+ *
+ * Protocol: each line on stdin/stdout is a single JSON-RPC 2.0 message.
+ */
+export interface StdioServerConfig {
+    verbose: boolean;
+}
+export declare class StdioServer {
+    private running;
+    private activeTurn;
+    private pendingToolResults;
+    private verbose;
+    private registry;
+    private agent;
+    private lastLlmConfigKey;
+    private currentSessionId;
+    private currentHooks;
+    constructor(config: StdioServerConfig);
+    start(): void;
+    stop(): void;
+    private handleMessage;
+    private handleHello;
+    private handlePing;
+    private handleAbort;
+    private handleToolResult;
+    private handleTurn;
+    private resolveAgent;
+    /**
+     * Request tool execution from the Gateway host.
+     * Sends a turn.tool_call notification and waits for tool.result.
+     */
+    requestToolExecution(turnId: string, name: string, args: string, signal?: AbortSignal): Promise<{
+        result: string;
+        error?: string;
+    }>;
+    private sendResponse;
+    private sendNotification;
+    private writeStdout;
+    private log;
+}
+//# sourceMappingURL=stdio-server.d.ts.map

package/dist/cli/stdio-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-server.d.ts","sourceRoot":"","sources":["../../src/cli/stdio-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyCH,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,kBAAkB,CAAwC;IAClE,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,YAAY,CAA6D;gBAErE,MAAM,EAAE,iBAAiB;IAKrC,KAAK,IAAI,IAAI;IA8Bb,IAAI,IAAI,IAAI;IA0BZ,OAAO,CAAC,aAAa;IAmCrB,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,gBAAgB;YAmBV,UAAU;IAkLxB,OAAO,CAAC,YAAY;IAkGpB;;;OAGG;IACG,oBAAoB,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAgC9C,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,GAAG;CAKX"}