qlogicagent 0.2.1 → 0.4.0

package/dist/agent/types.d.ts

@@ -1,175 +0,0 @@
-/**
- * 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 };

package/dist/agent/types.js

@@ -1,14 +0,0 @@
-/**
- * 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 {};

package/dist/cli/main.d.ts

@@ -1,11 +0,0 @@
-#!/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 {};

package/dist/cli/main.js

@@ -1,23 +0,0 @@
-#!/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();

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

@@ -1,45 +0,0 @@
-/**
- * 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;
-}