qlogicagent 2.24.1 → 2.24.2

package/dist/types/protocol/wire/agent-methods.d.ts

@@ -1,500 +0,0 @@
-/**
- * Agent RPC Method Map — complete typed contract for ALL agent JSON-RPC methods.
- *
- * This extends GatewayRpcMethodMap (26 methods Gateway directly calls) with all
- * additional agent-specific methods (thread, memory, agents, solo, product, etc.).
- *
- * Consumers use this for fully typed RPC clients:
- *   import type { AgentRpcMethodMap } from "qlogicagent/protocol";
- *   async function call<M extends keyof AgentRpcMethodMap>(method: M, params: AgentRpcMethodMap[M]["params"]): Promise<AgentRpcMethodMap[M]["result"]> { ... }
- */
-import type { ChatMessage, LocalizedToolText, ToolCapabilityCategory } from "./chat-types.js";
-import type { GatewayRpcMethodMap } from "./gateway-rpc.js";
-import type { WireTokenUsage } from "./notification-payloads.js";
-export type SoloState = "running" | "evaluating" | "completed" | "cancelled" | "failed";
-export type SoloAgentState = "pending" | "running" | "completed" | "failed" | "idle";
-export interface SoloAgentResult {
-    id: string;
-    state: SoloAgentState;
-    progress?: string;
-    resultText?: string;
-    diff?: string;
-    usage?: {
-        inputTokens: number;
-        outputTokens: number;
-    };
-    error?: string;
-    worktreePath?: string;
-}
-export interface SoloStatus {
-    soloId: string;
-    projectId: string;
-    state: SoloState;
-    agents: SoloAgentResult[];
-    evaluation?: {
-        winnerId: string;
-        reasoning: string;
-        adopted?: boolean;
-        judgedBy?: string;
-        degraded?: boolean;
-    };
-    /** Original task text — history reopen must show what the race was about. */
-    task?: string;
-    /** Clarified Spec (goal/constraints/acceptance) when the race was started from one. */
-    spec?: {
-        goal: string;
-        constraints: string[];
-        acceptance: string[];
-        rawTask?: string;
-    };
-    /** Epoch ms the race started. */
-    createdAt?: number;
-}
-export type ProductPhase = "active" | "paused" | "completed" | "failed";
-export type ProductTaskStatus = "pending" | "running" | "completed" | "failed" | "paused" | "skipped";
-export interface ProductInstanceDef {
-    name: string;
-    role: string;
-    agentId: string;
-}
-export interface ProductTaskDef {
-    taskId: string;
-    assignee: string;
-    prompt: string;
-    dependsOn?: string[];
-    /** Leader-authored "done" criteria: files to produce / how to self-check / terminal PASS.
-     *  Appended to the task prompt so the evidence gate (assertProductTaskCompletionEvidence) sees it. */
-    acceptanceCriteria?: string;
-}
-export interface ProductStatus {
-    productId: string;
-    projectId: string;
-    name: string;
-    phase: ProductPhase;
-    instances: Array<{
-        instanceId: string;
-        name: string;
-        agentId: string;
-        state: string;
-        worktreePath?: string;
-        usage?: {
-            inputTokens: number;
-            outputTokens: number;
-        };
-    }>;
-    tasks: Array<{
-        taskId: string;
-        assignee: string;
-        status: ProductTaskStatus;
-        result?: string;
-        error?: string;
-        startedAt?: string;
-        completedAt?: string;
-        inputTokens?: number;
-        outputTokens?: number;
-        changedFiles?: string[];
-    }>;
-    budget: {
-        maxTotalTokens?: number;
-        maxDuration?: number;
-        usedTokens: number;
-        elapsed: number;
-    };
-    lastCheckpointAt: string;
-}
-export interface ProductSummary {
-    productId: string;
-    name: string;
-    phase: ProductPhase;
-    instanceCount: number;
-    taskCount: number;
-    completedTasks: number;
-    createdAt: string;
-    lastCheckpointAt: string;
-}
-/**
- * All agent RPC methods — superset of GatewayRpcMethodMap.
- *
- * Methods from GatewayRpcMethodMap (session.*, project.*, files.*, instructions.*)
- * are inherited. This adds the agent-specific protocol methods.
- */
-export interface AgentRpcMethodMap extends GatewayRpcMethodMap {
-    "initialize": {
-        params: {
-            protocolVersion: string;
-            host?: {
-                name: string;
-                version: string;
-            };
-            hostName?: string;
-            hostVersion?: string;
-            capabilities?: {
-                streaming?: boolean;
-                toolApproval?: boolean;
-                threads?: boolean;
-            };
-            config?: Record<string, unknown>;
-        };
-        result: {
-            protocolVersion: string;
-            agent: {
-                name: string;
-                version: string;
-            };
-            capabilities: {
-                tools: string[];
-                streaming: boolean;
-                threads: boolean;
-                notifications: string[];
-                methods: string[];
-            };
-        };
-    };
-    "thread.create": {
-        params: {
-            id?: string;
-            title?: string;
-            cwd?: string;
-            config?: Record<string, unknown>;
-        };
-        result: {
-            id: string;
-            title?: string;
-            status: "active";
-            createdAt: string;
-        };
-    };
-    "thread.list": {
-        params: {
-            limit?: number;
-        };
-        result: {
-            threads: Array<{
-                id: string;
-                title?: string;
-                status: "active" | "archived";
-                turnCount?: number;
-                createdAt: string;
-                lastActiveAt: string;
-            }>;
-        };
-    };
-    "session.resume": {
-        params: {
-            sessionId: string;
-        };
-        result: {
-            metadata: {
-                sessionId: string;
-                projectId: string;
-                createdAt: string;
-                lastActiveAt: string;
-                model?: string;
-                cwd?: string;
-                turnCount: number;
-                messageCount: number;
-                title?: string;
-                totalInputTokens?: number;
-                totalOutputTokens?: number;
-            };
-            messages: ChatMessage[];
-        };
-    };
-    "session.getInfo": {
-        params: {
-            sessionId?: string;
-        };
-        result: {
-            sessionId: string;
-            paths: {
-                sessionDir: string;
-                transcript: string;
-                state: string;
-                agentHome: string;
-                settings: string;
-                cwd: string;
-            };
-            model?: string;
-            provider?: string;
-            turnCount: number;
-            title?: string;
-            usage?: {
-                totalPromptTokens: number;
-                totalCompletionTokens: number;
-                totalCost?: number;
-            };
-        };
-    };
-    "memory.list": {
-        params: {
-            source?: "local" | "store" | "qmemory" | "all";
-        };
-        result: {
-            entries: Array<{
-                source: "local" | "store" | "qmemory";
-                target?: string;
-                path?: string;
-                content?: string;
-                lines?: number;
-            }>;
-        };
-    };
-    "memory.read": {
-        params: {
-            source?: string;
-            target?: string;
-            path?: string;
-        };
-        result: {
-            content: string;
-            source: string;
-            path?: string;
-        };
-    };
-    "memory.write": {
-        params: {
-            source?: string;
-            target?: string;
-            path?: string;
-            content: string;
-            mode?: "overwrite" | "append";
-        };
-        result: {
-            ok: boolean;
-            path?: string;
-        };
-    };
-    "memory.delete": {
-        params: {
-            source?: string;
-            target?: string;
-            path?: string;
-        };
-        result: {
-            ok: boolean;
-            deleted?: number;
-        };
-    };
-    "memory.dream": {
-        params: {
-            scope?: "session" | "project" | "all";
-        };
-        result: {
-            ok: boolean;
-            consolidated: number;
-            archived: number;
-            durationMs: number;
-        };
-    };
-    "tools.list": {
-        params: {
-            category?: ToolCapabilityCategory;
-        };
-        result: {
-            tools: Array<{
-                id: string;
-                name: string;
-                category: ToolCapabilityCategory;
-                displayName: LocalizedToolText;
-                displayDescription: LocalizedToolText;
-                fallbackName: string;
-                fallbackDescription: string;
-                description: string;
-                source: "builtin";
-                parameters?: Record<string, unknown>;
-            }>;
-            total: number;
-        };
-    };
-    "todos.list": {
-        params: {
-            sessionId?: string;
-        };
-        result: {
-            items: Array<{
-                id: number;
-                title: string;
-                status: string;
-                owner?: string;
-                blockedBy?: number[];
-            }>;
-            summary: string;
-        };
-    };
-    "tasks.list": {
-        params: {
-            status?: string;
-        };
-        result: {
-            tasks: Array<{
-                id: string;
-                type: string;
-                status: string;
-                progress?: number;
-                createdAt: string;
-            }>;
-        };
-    };
-    "tasks.cancel": {
-        params: {
-            taskId: string;
-        };
-        result: {
-            ok: boolean;
-        };
-    };
-    "agent.ping": {
-        params: undefined;
-        result: {
-            status: "idle" | "busy";
-            uptime: number;
-            version: string;
-            usage?: WireTokenUsage;
-        };
-    };
-    "thread.user_response": {
-        params: {
-            requestId: string;
-            declined?: boolean;
-            answers?: Record<string, string>;
-        };
-        result: {
-            received: boolean;
-        };
-    };
-    "session.resolve": {
-        params: {
-            platform?: string;
-            chatId?: string;
-            chatType?: string;
-            userId?: string;
-            groupName?: string;
-            projectId?: string;
-            title?: string;
-        };
-        result: {
-            sessionId: string;
-            title?: string;
-            type: string;
-            agentId?: string;
-            ownerPlatform?: string;
-            ownerId?: string;
-            groupKey?: string;
-            groupPlatform?: string;
-            groupName?: string;
-            projectId?: string;
-        };
-    };
-    "session.focus": {
-        params: {
-            sessionId: string;
-            projectName?: string;
-        };
-        result: {
-            ok: false;
-        } | {
-            ok: true;
-            projectId: string;
-        };
-    };
-    "memory.atlas": GatewayRpcMethodMap["memory.atlas"];
-    "memory.activity": GatewayRpcMethodMap["memory.activity"];
-    "memory.propose": GatewayRpcMethodMap["memory.propose"];
-    "memory.consolidate": GatewayRpcMethodMap["memory.consolidate"];
-    "memory.update": GatewayRpcMethodMap["memory.update"];
-    "memory.attachment.adopt": GatewayRpcMethodMap["memory.attachment.adopt"];
-    "memory.attachment.locate": GatewayRpcMethodMap["memory.attachment.locate"];
-    "community.resolveInstall": {
-        params: {
-            resourceId: string;
-            version?: string;
-            explicitInstallConsent: true;
-            explicitHighRiskConsent?: true;
-        };
-        result: {
-            ok: boolean;
-            install: Record<string, unknown>;
-        };
-    };
-    "community.listResourceVersions": {
-        params: {
-            resourceId: string;
-        };
-        result: {
-            ok: true;
-            versions: unknown;
-        };
-    };
-    "community.installResource": {
-        params: {
-            resourceId: string;
-            version?: string;
-            explicitInstallConsent: true;
-            allowReplace?: boolean;
-            replacementPolicy?: "managed-unmodified" | "user-confirmed";
-        };
-        result: {
-            ok: boolean;
-            installed?: Record<string, unknown>;
-            preview?: Record<string, unknown>;
-        };
-    };
-    "community.runtimeStatus": {
-        params: {
-            ids: string[];
-        };
-        result: {
-            ok: boolean;
-            items: Array<Record<string, unknown>>;
-        };
-    };
-    "community.installRuntime": {
-        params: {
-            id: string;
-        };
-        result: {
-            ok: boolean;
-            id: string;
-            version?: string;
-            binPath?: string;
-        };
-    };
-    "agent.health": GatewayRpcMethodMap["agent.health"];
-    "agent.metrics": GatewayRpcMethodMap["agent.metrics"];
-    "agent.cancel": GatewayRpcMethodMap["agent.cancel"];
-    "session.moveToProject": GatewayRpcMethodMap["session.moveToProject"];
-    "instructions.list": GatewayRpcMethodMap["instructions.list"];
-    "instructions.read": GatewayRpcMethodMap["instructions.read"];
-    "instructions.write": GatewayRpcMethodMap["instructions.write"];
-    "instructions.delete": GatewayRpcMethodMap["instructions.delete"];
-    "plans.list": {
-        params: {
-            projectId?: string;
-        };
-        result: {
-            plans: Array<{
-                slug: string;
-                name: string;
-                title: string;
-                status?: string;
-                path: string;
-                size: number;
-            }>;
-        };
-    };
-    "skills.promote": {
-        params: {
-            name: string;
-        };
-        result: {
-            ok: true;
-            promoted: string;
-            scope: "global";
-            globalPath: string;
-        };
-    };
-    "skills.curator": {
-        params: undefined;
-        result: Record<string, unknown>;
-    };
-}

package/dist/types/protocol/wire/agent-rpc.d.ts

@@ -1,100 +0,0 @@
-/**
- * Protocol version. Both sides exchange this during `agent.hello`
- * handshake. If major versions differ the host MUST reject.
- */
-export declare const AGENT_RPC_PROTOCOL_VERSION: "1.0.0";
-export declare const AGENT_RPC_ERROR_CODES: {
-    readonly PARSE_ERROR: -32700;
-    readonly INVALID_REQUEST: -32600;
-    readonly METHOD_NOT_FOUND: -32601;
-    readonly INVALID_PARAMS: -32602;
-    readonly INTERNAL_ERROR: -32603;
-    readonly TURN_ABORTED: -32000;
-    readonly TURN_TIMEOUT: -32001;
-    readonly LLM_ERROR: -32010;
-    readonly LLM_AUTH_ERROR: -32011;
-    readonly LLM_RATE_LIMIT: -32012;
-    readonly LLM_QUOTA_EXHAUSTED: -32013;
-    readonly LLM_MODEL_NOT_FOUND: -32014;
-    readonly TOOL_INVOKE_FAILED: -32020;
-    readonly TOOL_TIMEOUT: -32021;
-    readonly PROTOCOL_MISMATCH: -32030;
-    readonly REQUEST_DEADLINE_EXCEEDED: -32040;
-    readonly REQUEST_CANCELLED: -32041;
-    readonly REQUEST_DEDUPED: -32042;
-    readonly REQUEST_IDEMPOTENCY_REQUIRED: -32043;
-};
-export type AgentRpcErrorCode = (typeof AGENT_RPC_ERROR_CODES)[keyof typeof AGENT_RPC_ERROR_CODES];
-export interface AgentRpcRequest {
-    jsonrpc: "2.0";
-    method: string;
-    params?: Record<string, unknown>;
-    id?: string | number;
-    meta?: AgentRpcMeta;
-}
-export type AgentRpcChannel = "query" | "task";
-export interface AgentRpcMeta {
-    requestId: string;
-    deadlineAt: number;
-    createdAt: number;
-    channel: AgentRpcChannel;
-    idempotencyKey?: string;
-    traceId?: string;
-}
-export interface AgentRpcError {
-    code: AgentRpcErrorCode | number;
-    message: string;
-    data?: unknown;
-}
-export interface AgentRpcResponse {
-    jsonrpc: "2.0";
-    id: string | number;
-    result?: unknown;
-    error?: AgentRpcError;
-}
-export interface AgentRpcNotification {
-    jsonrpc: "2.0";
-    method: string;
-    params: Record<string, unknown>;
-}
-export type AgentRpcMessage = AgentRpcRequest | AgentRpcResponse | AgentRpcNotification;
-/** Sent by host to agent CLI as params of `agent.hello` request. */
-export interface AgentHelloParams {
-    protocolVersion: string;
-    hostName: string;
-    hostVersion: string;
-    capabilities?: string[];
-}
-/** Returned by agent CLI as result of `agent.hello` request. */
-export interface AgentHelloResult {
-    protocolVersion: string;
-    agentName: string;
-    agentVersion: string;
-    capabilities?: string[];
-}
-/**
- * Agent → Host notification: agent requests human approval before executing a tool.
- * Method name: `tool.approval.request`
- */
-export interface ToolApprovalRequestParams {
-    /** Unique id for this approval request (used to correlate the response). */
-    approvalId: string;
-    /** Tool call id from the LLM. */
-    callId: string;
-    /** Tool name. */
-    toolName: string;
-    /** Serialized arguments JSON. */
-    arguments: string;
-    /** Human-readable reason for requiring approval. */
-    message?: string;
-    /** Suggested allow/ask/deny policy updates the user can apply with the decision. */
-    suggestions?: string[];
-}
-/** Well-known method names for the approval protocol. */
-export declare const AGENT_RPC_APPROVAL_METHODS: {
-    readonly REQUEST: "tool.approval.request";
-};
-export declare function isAgentRpcRequest(msg: unknown): msg is AgentRpcRequest;
-export declare function isAgentRpcResponse(msg: unknown): msg is AgentRpcResponse;
-export declare function isAgentRpcNotification(msg: unknown): msg is AgentRpcNotification;
-export declare function parseAgentRpcMessage(raw: string): AgentRpcMessage | null;

package/dist/types/protocol/wire/gateway-contract.d.ts

@@ -1,61 +0,0 @@
-import { type AgentRpcError, type AgentRpcMeta, type AgentRpcRequest, type AgentRpcChannel } from "./agent-rpc.js";
-export type GatewayRpcMutability = "read" | "write";
-export interface GatewayRpcClassification {
-    channel: AgentRpcChannel;
-    mutability: GatewayRpcMutability;
-    defaultTimeoutMs: number;
-}
-export interface GatewayRpcMetrics {
-    activeRequests: number;
-    completedRequests: number;
-    cancelledRequests: number;
-    deadlineExceededRequests: number;
-    dedupedRequests: number;
-    lateResponsesDropped: number;
-    invalidRequests: number;
-}
-export declare function classifyGatewayRpcMethod(method: string): GatewayRpcClassification;
-export declare function requiresIdempotencyKey(method: string): boolean;
-export declare function buildAgentRpcMeta(method: string, options?: {
-    now?: number;
-    timeoutMs?: number;
-    requestId?: string;
-    idempotencyKey?: string;
-    traceId?: string;
-    channel?: AgentRpcChannel;
-}): AgentRpcMeta;
-export declare function requireGatewayRpcMeta(request: Pick<AgentRpcRequest, "method" | "meta">, now?: number): {
-    ok: true;
-    meta: AgentRpcMeta;
-} | {
-    ok: false;
-    error: AgentRpcError;
-};
-export declare class GatewayRpcContract {
-    private readonly now;
-    private readonly active;
-    private readonly idempotency;
-    private readonly counters;
-    constructor(options?: {
-        now?: () => number;
-    });
-    begin(method: string, meta: AgentRpcMeta): {
-        status: "started";
-    } | {
-        status: "deduped";
-        result?: unknown;
-        error?: AgentRpcError;
-    } | {
-        status: "rejected";
-        error: AgentRpcError;
-    };
-    cancel(requestId: string, reason?: string): boolean;
-    expire(requestId: string): boolean;
-    settle(requestId: string, result?: unknown, error?: AgentRpcError): {
-        accepted: true;
-    } | {
-        accepted: false;
-        reason: "unknown" | "cancelled" | "deadline_exceeded";
-    };
-    metrics(): GatewayRpcMetrics;
-}