qlogicagent 0.1.0

package/dist/cli/stdio-server.js

@@ -0,0 +1,464 @@
+/**
+ * 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.
+ */
+import { createInterface } from "node:readline";
+import { randomUUID } from "node:crypto";
+import { Agent } from "../agent/agent.js";
+import { ProviderRegistry, createLLMClient, autoDetectProvider, } from "../llm/index.js";
+import { createHookRegistry } from "../runtime/hook-registry.js";
+import { registerMemoryHooks } from "../runtime/memory-hooks.js";
+import { createQMemoryAdapter } from "../skills/qmemory-adapter.js";
+import { AGENT_RPC_ERROR_CODES, AGENT_RPC_PROTOCOL_VERSION, isAgentRpcRequest, } from "qlogicagent-runtime-contracts";
+export class StdioServer {
+    running = false;
+    activeTurn = null;
+    pendingToolResults = new Map();
+    verbose;
+    registry;
+    agent = null;
+    lastLlmConfigKey = "";
+    currentSessionId = "";
+    currentHooks = null;
+    constructor(config) {
+        this.verbose = config.verbose;
+        this.registry = new ProviderRegistry();
+    }
+    start() {
+        this.running = true;
+        this.log("qlogicagent CLI started, waiting for JSON-RPC on stdin...");
+        const rl = createInterface({
+            input: process.stdin,
+            crlfDelay: Number.POSITIVE_INFINITY,
+        });
+        rl.on("line", (line) => {
+            const trimmed = line.trim();
+            if (!trimmed)
+                return;
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (!isAgentRpcRequest(parsed)) {
+                    this.log(`[warn] ignoring non-request message: ${trimmed.slice(0, 200)}`);
+                    return;
+                }
+                this.handleMessage(parsed);
+            }
+            catch {
+                this.log(`[warn] invalid JSON on stdin: ${trimmed.slice(0, 200)}`);
+            }
+        });
+        rl.on("close", () => {
+            this.log("stdin closed, shutting down");
+            this.stop();
+        });
+    }
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        // Fire session.ended for active session
+        if (this.currentSessionId && this.currentHooks) {
+            this.currentHooks.invoke("session.ended", { sessionId: this.currentSessionId }).catch(() => { });
+        }
+        // Abort active turn if any
+        if (this.activeTurn) {
+            this.activeTurn.abort();
+            this.activeTurn = null;
+        }
+        // Reject all pending tool results
+        for (const [callId, pending] of this.pendingToolResults) {
+            pending.resolve({ result: "", error: "Agent process shutting down" });
+        }
+        this.pendingToolResults.clear();
+        this.log("stopped");
+    }
+    // ── Message dispatch ──────────────────────────────────────────────────
+    handleMessage(msg) {
+        switch (msg.method) {
+            case "agent.hello":
+                this.handleHello(msg);
+                break;
+            case "agent.ping":
+                this.handlePing(msg);
+                break;
+            case "agent.turn":
+                this.handleTurn(msg);
+                break;
+            case "memory.dream":
+                // Dream turns use the same agent.turn pipeline with dream-specific
+                // system prompt and messages. The Gateway sends memory.dream but the
+                // agent treats it as a regular turn with dream context.
+                this.handleTurn(msg);
+                break;
+            case "agent.abort":
+                this.handleAbort(msg);
+                break;
+            case "tool.result":
+                this.handleToolResult(msg);
+                break;
+            default:
+                if (msg.id !== undefined) {
+                    this.sendResponse(msg.id, undefined, {
+                        code: AGENT_RPC_ERROR_CODES.METHOD_NOT_FOUND,
+                        message: `Unknown method: ${msg.method}`,
+                    });
+                }
+        }
+    }
+    // ── Handlers ──────────────────────────────────────────────────────────
+    handleHello(msg) {
+        const params = msg.params;
+        const hostVersion = params?.protocolVersion ?? "unknown";
+        const majorHost = hostVersion.split(".")[0];
+        const majorSelf = AGENT_RPC_PROTOCOL_VERSION.split(".")[0];
+        if (majorHost !== majorSelf) {
+            this.log(`protocol mismatch: host=${hostVersion} agent=${AGENT_RPC_PROTOCOL_VERSION}`);
+            if (msg.id !== undefined) {
+                this.sendResponse(msg.id, undefined, {
+                    code: AGENT_RPC_ERROR_CODES.PROTOCOL_MISMATCH,
+                    message: `Protocol version mismatch: host=${hostVersion}, agent=${AGENT_RPC_PROTOCOL_VERSION}`,
+                });
+            }
+            return;
+        }
+        this.log(`hello from ${params?.hostName ?? "unknown"} v${params?.hostVersion ?? "?"} (protocol ${hostVersion})`);
+        if (msg.id !== undefined) {
+            this.sendResponse(msg.id, {
+                protocolVersion: AGENT_RPC_PROTOCOL_VERSION,
+                agentName: "qlogicagent",
+                agentVersion: "0.1.0",
+                capabilities: ["turn", "tool-invoke", "streaming"],
+            });
+        }
+    }
+    handlePing(msg) {
+        if (msg.id !== undefined) {
+            this.sendResponse(msg.id, { status: "ok" });
+        }
+        this.sendNotification("pong", {});
+    }
+    handleAbort(msg) {
+        const turnId = msg.params?.turnId ?? "";
+        this.log(`abort requested for turn ${turnId}`);
+        if (this.activeTurn) {
+            this.activeTurn.abort();
+            this.activeTurn = null;
+        }
+        if (msg.id !== undefined) {
+            this.sendResponse(msg.id, { aborted: true });
+        }
+    }
+    handleToolResult(msg) {
+        const callId = msg.params?.callId;
+        const result = msg.params?.result ?? "";
+        const error = msg.params?.error;
+        if (!callId) {
+            this.log("[warn] tool.result missing callId");
+            return;
+        }
+        const pending = this.pendingToolResults.get(callId);
+        if (pending) {
+            pending.resolve({ result, error });
+            this.pendingToolResults.delete(callId);
+        }
+        else {
+            this.log(`[warn] no pending tool call for callId ${callId}`);
+        }
+    }
+    async handleTurn(msg) {
+        const params = msg.params ?? {};
+        const turnId = params.turnId ?? randomUUID();
+        const sessionId = params.sessionId;
+        const messages = params.messages ?? [];
+        const tools = params.tools ?? [];
+        const config = params.config;
+        if (msg.id !== undefined) {
+            this.sendResponse(msg.id, { accepted: true, turnId });
+        }
+        // Session lifecycle: fire session.created when sessionId changes
+        if (sessionId && sessionId !== this.currentSessionId) {
+            if (this.currentSessionId && this.currentHooks) {
+                this.currentHooks.invoke("session.ended", { sessionId: this.currentSessionId }).catch(() => { });
+            }
+            this.currentSessionId = sessionId;
+            // session.created is fired after hooks are available (below in resolveAgent)
+        }
+        const ac = new AbortController();
+        this.activeTurn = ac;
+        this.log(`turn ${turnId} starting (session: ${sessionId})`);
+        try {
+            // ─── Resolve or create Agent with LLM config ──────────────
+            const turnConfig = {
+                provider: config?.provider,
+                model: config?.model,
+                apiKey: config?.apiKey,
+                baseUrl: config?.baseUrl,
+                maxRounds: config?.maxRounds,
+                temperature: config?.temperature,
+                contextWindowTokens: config?.contextWindowTokens,
+                maxOutputTokens: config?.maxOutputTokens,
+                modelMaxOutputTokens: config?.modelMaxOutputTokens,
+            };
+            const agent = this.resolveAgent(turnConfig);
+            if (!agent) {
+                this.sendNotification("turn.start", { turnId });
+                this.sendNotification("turn.error", {
+                    turnId,
+                    error: "No LLM provider configured. Provide provider/model/apiKey in agent.turn config, " +
+                        "or set DEEPSEEK_API_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY environment variable.",
+                    code: "NO_PROVIDER",
+                });
+                return;
+            }
+            // ─── Stream events from Agent ─────────────────────────────
+            const systemPrompt = config?.systemPrompt;
+            for await (const event of agent.run({
+                turnId,
+                sessionId,
+                messages,
+                tools,
+                systemPrompt,
+                config: turnConfig,
+            }, ac.signal)) {
+                // Forward all TurnEvent as JSON-RPC notifications
+                switch (event.type) {
+                    case "start":
+                        this.sendNotification("turn.start", { turnId: event.turnId });
+                        break;
+                    case "delta":
+                        this.sendNotification("turn.delta", {
+                            turnId: event.turnId,
+                            text: event.text,
+                        });
+                        break;
+                    case "end":
+                        this.sendNotification("turn.end", {
+                            turnId: event.turnId,
+                            content: event.content,
+                            usage: event.usage,
+                            model: event.model,
+                            provider: event.provider,
+                        });
+                        break;
+                    case "error":
+                        this.sendNotification("turn.error", {
+                            turnId: event.turnId,
+                            error: event.error,
+                            code: event.code,
+                        });
+                        break;
+                    case "skill_instruction":
+                        this.sendNotification("turn.skill_instruction", {
+                            turnId: event.turnId,
+                            instruction: event.instruction,
+                        });
+                        break;
+                    case "tool_call":
+                        // Informational only — actual execution RPC is handled
+                        // by requestToolExecution() when toolInvoker.invoke() is called.
+                        break;
+                    case "tool_result":
+                        this.sendNotification("turn.tool_result", {
+                            turnId: event.turnId,
+                            callId: event.callId,
+                            name: event.name,
+                            ok: event.ok,
+                            ...(event.error ? { error: event.error } : {}),
+                        });
+                        break;
+                    case "sidechain_started":
+                        this.sendNotification("turn.sidechain_started", {
+                            turnId: event.turnId,
+                            depth: event.depth,
+                            role: event.role,
+                        });
+                        break;
+                    case "sidechain_completed":
+                        this.sendNotification("turn.sidechain_completed", {
+                            turnId: event.turnId,
+                            depth: event.depth,
+                            toolCallCount: event.toolCallCount,
+                        });
+                        break;
+                    case "tool_blocked":
+                        this.sendNotification("turn.tool_blocked", {
+                            turnId: event.turnId,
+                            callId: event.callId,
+                            name: event.name,
+                            reason: event.reason,
+                        });
+                        break;
+                    case "recovery":
+                        this.sendNotification("turn.recovery", {
+                            turnId: event.turnId,
+                            action: event.action,
+                            ...(event.detail ? { detail: event.detail } : {}),
+                        });
+                        break;
+                    case "plan_update":
+                        this.sendNotification("turn.plan_update", {
+                            turnId: event.turnId,
+                            slug: event.slug,
+                            content: event.content,
+                        });
+                        break;
+                }
+            }
+            this.log(`turn ${turnId} completed`);
+        }
+        catch (err) {
+            if (ac.signal.aborted) {
+                this.sendNotification("turn.error", {
+                    turnId,
+                    error: "Turn aborted",
+                    code: "ABORTED",
+                });
+            }
+            else {
+                const message = err instanceof Error ? err.message : String(err);
+                this.sendNotification("turn.error", {
+                    turnId,
+                    error: message,
+                    code: "INTERNAL_ERROR",
+                });
+            }
+        }
+        finally {
+            if (this.activeTurn === ac) {
+                this.activeTurn = null;
+            }
+        }
+    }
+    // ── Agent resolution (lazy create / re-create on config change) ───────
+    resolveAgent(config) {
+        // Build a config key to detect provider/model/key changes
+        const configKey = `${config.provider ?? ""}:${config.model ?? ""}:${config.apiKey?.slice(0, 8) ?? ""}:${config.baseUrl ?? ""}`;
+        if (this.agent && this.lastLlmConfigKey === configKey) {
+            return this.agent;
+        }
+        // Try explicit config first
+        let provider = config.provider;
+        let model = config.model;
+        let apiKey = config.apiKey;
+        const baseUrl = config.baseUrl;
+        if (!provider || !apiKey) {
+            // Fallback: auto-detect from env
+            const detected = autoDetectProvider(this.registry);
+            if (detected) {
+                provider = provider ?? detected.providerId;
+                apiKey = apiKey ?? detected.apiKey;
+                model = model ?? detected.defaultModel;
+                this.log(`auto-detected provider: ${provider}, model: ${model}`);
+            }
+        }
+        if (!provider || !apiKey) {
+            return null;
+        }
+        model = model ?? this.registry.getProvider(provider)?.defaultModel ?? "";
+        const client = createLLMClient({ provider, model, apiKey, baseUrl }, this.registry);
+        const log = {
+            info: (m) => this.log(m),
+            warn: (m) => this.log(`[warn] ${m}`),
+            error: (m) => this.log(`[error] ${m}`),
+            debug: (m) => {
+                if (this.verbose)
+                    this.log(`[debug] ${m}`);
+            },
+        };
+        const toolInvoker = {
+            invoke: (turnId, name, args, signal) => this.requestToolExecution(turnId, name, args, signal),
+        };
+        // ─── HookRegistry ────────────────────────────────────────
+        // Skill learning: handled directly in tool-loop (has full metrics context).
+        // The tool-loop yields `skill_instruction` events → forwarded above in handleTurn().
+        // HookRegistry is available for context-compression and future hooks.
+        const hooks = createHookRegistry(log);
+        this.currentHooks = hooks;
+        // ─── Memory hooks (qmemory REST API) ─────────────────────
+        const qmemoryBaseUrl = (process.env.QMEMORY_BASE_URL ??
+            process.env.QLOGICAGENT_QMEMORY_BASE_URL ??
+            "").trim().replace(/\/+$/, "");
+        if (qmemoryBaseUrl) {
+            const memoryProvider = createQMemoryAdapter({
+                baseUrl: qmemoryBaseUrl,
+                apiKey: (process.env.QMEMORY_API_KEY ?? "").trim() || undefined,
+                timeoutMs: 5_000,
+            });
+            registerMemoryHooks(hooks, {
+                memoryProvider,
+                userId: this.currentSessionId ?? "default",
+                log: { debug: (m) => log.debug(m), warn: (m) => log.warn(m) },
+            });
+        }
+        // Fire session.created for the current session
+        if (this.currentSessionId) {
+            hooks.invoke("session.created", { sessionId: this.currentSessionId }).catch(() => { });
+        }
+        this.agent = new Agent({
+            llmTransport: client.transport,
+            apiKey: client.apiKey,
+            toolInvoker,
+            log,
+            hooks,
+            maxRounds: config.maxRounds,
+            verbose: this.verbose,
+        });
+        this.lastLlmConfigKey = configKey;
+        this.log(`created Agent (provider: ${provider}, model: ${model})`);
+        return this.agent;
+    }
+    // ── Tool call request (used by real Agent in Phase 2+) ────────────────
+    /**
+     * Request tool execution from the Gateway host.
+     * Sends a turn.tool_call notification and waits for tool.result.
+     */
+    async requestToolExecution(turnId, name, args, signal) {
+        const callId = `tc_${randomUUID().slice(0, 8)}`;
+        return new Promise((resolve, reject) => {
+            if (signal?.aborted) {
+                reject(new Error("Aborted"));
+                return;
+            }
+            this.pendingToolResults.set(callId, { resolve });
+            const onAbort = () => {
+                this.pendingToolResults.delete(callId);
+                reject(new Error("Aborted"));
+            };
+            signal?.addEventListener("abort", onAbort, { once: true });
+            this.sendNotification("turn.tool_call", {
+                turnId,
+                callId,
+                name,
+                arguments: args,
+            });
+        });
+    }
+    // ── Helpers ───────────────────────────────────────────────────────────
+    // ── I/O ───────────────────────────────────────────────────────────────
+    sendResponse(id, result, error) {
+        const msg = { jsonrpc: "2.0", id };
+        if (error)
+            msg.error = error;
+        else
+            msg.result = result;
+        this.writeStdout(msg);
+    }
+    sendNotification(method, params) {
+        const msg = { jsonrpc: "2.0", method, params };
+        this.writeStdout(msg);
+    }
+    writeStdout(msg) {
+        process.stdout.write(`${JSON.stringify(msg)}\n`);
+    }
+    log(message) {
+        if (this.verbose) {
+            process.stderr.write(`[qlogicagent] ${message}\n`);
+        }
+    }
+}
+//# sourceMappingURL=stdio-server.js.map

package/dist/cli/stdio-server.js.map

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

package/dist/config/config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Centralized CLI startup configuration.
+ *
+ * Parses and validates all configuration from CLI args and environment.
+ * Single source of truth for qlogicagent runtime config.
+ */
+export interface AgentConfig {
+    /** Enable verbose logging to stderr. */
+    verbose: boolean;
+}
+/**
+ * Parse CLI arguments into AgentConfig.
+ *
+ * Supports:
+ *   --verbose / -v   Enable verbose logging
+ */
+export declare function parseCliArgs(argv: string[]): AgentConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC3B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAUxD"}

package/dist/config/config.js

@@ -0,0 +1,22 @@
+/**
+ * Centralized CLI startup configuration.
+ *
+ * Parses and validates all configuration from CLI args and environment.
+ * Single source of truth for qlogicagent runtime config.
+ */
+/**
+ * Parse CLI arguments into AgentConfig.
+ *
+ * Supports:
+ *   --verbose / -v   Enable verbose logging
+ */
+export function parseCliArgs(argv) {
+    const config = { verbose: false };
+    for (const arg of argv.slice(2)) {
+        if (arg === "--verbose" || arg === "-v") {
+            config.verbose = true;
+        }
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IAC1C,MAAM,MAAM,GAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAE/C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACzC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/contracts/hooks.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Hook system types for the Agent Runtime.
+ *
+ * Hooks allow hosts and middleware to intercept, modify, or observe events
+ * at well-defined lifecycle points during session, turn, and tool execution.
+ */
+/**
+ * All supported hook points in the Agent Runtime lifecycle.
+ */
+export type HookPoint = "session.created" | "session.ended" | "turn.submitted" | "turn.before_inference" | "turn.after_inference" | "turn.completed" | "turn.failed" | "tool.before_invoke" | "tool.after_invoke" | "tool.invoke_failed" | "approval.requested" | "approval.responded" | "context.before_compact" | "context.after_compact" | "memory.before_recall" | "memory.after_recall";
+export interface HookSessionContext {
+    sessionId: string;
+    gatewayId?: string;
+    deviceId?: string;
+    mode?: string;
+}
+export interface HookTurnContext extends HookSessionContext {
+    turnId: string;
+    executionId?: string;
+    rootExecutionId?: string;
+}
+export interface HookToolContext extends HookTurnContext {
+    callId: string;
+    toolName: string;
+    arguments?: Record<string, unknown>;
+}
+export interface HookApprovalContext extends HookTurnContext {
+    approvalId: string;
+    callId?: string;
+    toolName?: string;
+    decision?: "approved" | "denied" | "expired" | "cancelled";
+}
+export interface HookContextMap {
+    "session.created": HookSessionContext;
+    "session.ended": HookSessionContext;
+    "turn.submitted": HookTurnContext & {
+        prompt?: string;
+    };
+    "turn.before_inference": HookTurnContext & {
+        model?: string;
+        messages?: unknown[];
+    };
+    "turn.after_inference": HookTurnContext & {
+        model?: string;
+        response?: unknown;
+        success?: boolean;
+        error?: string;
+    };
+    "turn.completed": HookTurnContext & {
+        outcomeId?: string;
+    };
+    "turn.failed": HookTurnContext & {
+        code?: string;
+        error?: string;
+    };
+    "tool.before_invoke": HookToolContext;
+    "tool.after_invoke": HookToolContext & {
+        result?: unknown;
+        ok: boolean;
+    };
+    "tool.invoke_failed": HookToolContext & {
+        error?: string;
+    };
+    "approval.requested": HookApprovalContext;
+    "approval.responded": HookApprovalContext;
+    "context.before_compact": HookTurnContext & {
+        tokenCount?: number;
+        messageCount?: number;
+    };
+    "context.after_compact": HookTurnContext & {
+        tokenCount?: number;
+        removedCount?: number;
+    };
+    "memory.before_recall": HookTurnContext & {
+        query?: string;
+    };
+    "memory.after_recall": HookTurnContext & {
+        blockCount?: number;
+    };
+}
+/**
+ * Result of a hook handler invocation.
+ *
+ * - `continue`: proceed normally (optionally with modified context)
+ * - `abort`: stop execution (for "before" hooks only)
+ * - `skip`: skip this step but continue the overall flow
+ */
+export interface HookResult<T = unknown> {
+    action: "continue" | "abort" | "skip";
+    /** Modified context to pass downstream (only for "continue") */
+    context?: T;
+    /** Reason for abort/skip (for logging) */
+    reason?: string;
+}
+/**
+ * A hook handler function.
+ *
+ * @param point - The hook point being invoked
+ * @param context - Event-specific context data
+ * @returns A HookResult or void (treated as "continue")
+ */
+export type HookHandler<P extends HookPoint = HookPoint> = (point: P, context: HookContextMap[P]) => HookResult<HookContextMap[P]> | void | Promise<HookResult<HookContextMap[P]> | void>;
+/**
+ * Hook registration entry.
+ */
+export interface HookRegistration<P extends HookPoint = HookPoint> {
+    point: P;
+    handler: HookHandler<P>;
+    /** Priority (lower = earlier). Default: 100 */
+    priority?: number;
+    /** Optional label for debugging */
+    label?: string;
+}
+/**
+ * Interface for a hook registry that manages hook handlers.
+ */
+export interface HookRegistry {
+    register<P extends HookPoint>(registration: HookRegistration<P>): () => void;
+    invoke<P extends HookPoint>(point: P, context: HookContextMap[P]): Promise<HookResult<HookContextMap[P]>>;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/contracts/hooks.d.ts.map

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