@xiaozhiclaw/qlogicagent-core 0.4.1 → 0.6.0

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

@@ -1,164 +0,0 @@
-/**
- * Pure Agent types with zero I/O framework dependencies.
- *
- * Wire-level types (ChatMessage, ToolDefinition) are canonical in
- * contracts/. This file re-exports them and adds
- * execution configuration supplied by the product.
- */
-import type { HookRegistry } from "../contracts/hooks.js";
-import type { WireTokenUsage } from "../contracts/usage.js";
-import type { AccumulatedToolCall, LLMChunk, LLMRequest, LLMTransport } from "../runtime/ports/index.js";
-import type { ChatMessage as WireChatMessage, ChatMessageRole as WireChatMessageRole, ThinkingBlock as WireThinkingBlock, ToolCallMessage as WireToolCallMessage, ToolDefinition as WireToolDefinition } from "../contracts/chat.js";
-import type { ToolCallExecutionEvidence } from "../contracts/tool-execution-evidence.js";
-export type ChatMessageRole = WireChatMessageRole;
-export type ThinkingBlock = WireThinkingBlock;
-export type ToolCallMessage = WireToolCallMessage;
-export type ChatMessage = WireChatMessage;
-export type { AccumulatedToolCall, LLMChunk, LLMRequest, LLMTransport, };
-export type ToolDefinition = WireToolDefinition;
-/**
- * Token usage unified with WireTokenUsage from contracts.
- * No more internal/wire split: all code uses the same field names
- * (inputTokens, outputTokens, reasoningTokens, cacheRead, cacheWrite).
- */
-export type TokenUsage = WireTokenUsage;
-export type { TurnEvent, } from "../contracts/turn-event.js";
-/** Observable reason why the provider loop started another inference round. */
-export type ToolLoopTransition = {
-    reason: "reactive_compact_retry";
-} | {
-    reason: "next_turn";
-};
-/** Terminal exit reasons from the tool loop. */
-export type ToolLoopTerminal = {
-    reason: "completed";
-} | {
-    reason: "aborted";
-} | {
-    reason: "prompt_too_long";
-} | {
-    reason: "image_error";
-} | {
-    reason: "model_error";
-    error?: unknown;
-} | {
-    reason: "max_turns";
-} | {
-    reason: "budget_exhausted";
-} | {
-    reason: "tool_loop_limit";
-} | {
-    reason: "stop_hook_prevented";
-} | {
-    reason: "hook_stopped";
-};
-export interface TurnRequest {
-    turnId: string;
-    sessionId: string;
-    continuation?: {
-        completedRounds: number;
-        usage: TokenUsage;
-    };
-    messages: ChatMessage[];
-    /** Full registered tool surface before per-turn policy filtering. */
-    availableTools?: ToolDefinition[];
-    /** Exact tool names whose full parameter schemas are loaded only after Agent selection. */
-    deferredToolNames?: string[];
-    /**
-     * Session-owned names whose deferred schemas the Agent already selected and loaded.
-     * The loop reconciles this set against the current authoritative tool snapshot and
-     * adds newly loaded names; it never stores schema content or capability authority.
-     */
-    loadedDeferredToolNames?: Set<string>;
-    tools: ToolDefinition[];
-    /**
-     * Live tool-manifest rebuild, consulted each loop iteration (turnCount > 1).
-     * It may retract or restore tools from the turn's initial authoritative snapshot.
-     * Newly registered tools become visible on the next user turn so they cannot bypass
-     * the complete directory, schema deferral, or permission snapshot for this turn.
-     */
-    refreshTools?: () => ToolDefinition[];
-    /**
-     * Drain user guidance queued mid-turn (运行中引导). Consulted at the top of every
-     * tool-loop round; returned strings become user messages before the next LLM call.
-     */
-    drainPendingGuidance?: () => string[];
-    /**
-     * Drain bounded background-task results for this session. Consulted between
-     * rounds so completed product jobs can rejoin the parent without model polling.
-     */
-    drainPendingTaskNotifications?: () => string[];
-    /**
-     * Route media a tool returns that the MAIN model can't consume (e.g. `read` returning an image
-     * for a text-only model) to the understanding model; folds the description into the message text
-     * and drops the raw media. Forwarded to the tool loop; mutates the message in place.
-     */
-    sanitizeToolResultMedia?: (message: Record<string, unknown>) => Promise<void>;
-    systemPrompt?: string;
-    config?: TurnConfig;
-}
-export interface TurnConfig {
-    /** Model id, e.g. "deepseek-v4-flash" */
-    model?: string;
-    /** Inference credential injected by the product service. */
-    apiKey?: string;
-    /** Explicit max tool-call rounds per turn. Undefined means unbounded. */
-    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;
-    /** Tool choice strategy: "auto" (default), "none", "required" */
-    toolChoice?: "auto" | "none" | "required";
-    /** Max turns (tool loop iterations). 0 or undefined = use maxRounds. */
-    maxTurns?: number;
-    /** Max concurrent tool executions (0 = unlimited). */
-    maxConcurrentTools?: number;
-    /** Model requires streaming; disable transport-level non-streaming fallback. */
-    streamRequired?: boolean;
-    /** Reasoning effort for models that support it (GPT-5.x, o-series). */
-    reasoning?: {
-        effort: "auto" | "minimal" | "low" | "medium" | "high" | "xhigh";
-        includeEncryptedReasoning?: boolean;
-    };
-    /** Prompt cache bucketing key used instead of the provider-level `user` field. */
-    promptCacheKey?: string;
-    /** Prompt cache retention: "in_memory" (5-10min) or "24h". */
-    promptCacheRetention?: "in_memory" | "24h";
-    /** Service tier selected by the product model configuration. */
-    serviceTier?: "auto" | "default" | "flex" | "priority";
-    /** Max genuinely executable tool calls accepted from one model response; resets each round. */
-    maxToolCalls?: number;
-    /** Disable parallel tool calling (force sequential). */
-    parallelToolCalls?: boolean;
-    /** Text output verbosity hint: "low", "medium", "high". */
-    textVerbosity?: "low" | "medium" | "high";
-}
-export type { ToolCallExecutionEvidence };
-/**
- * ToolInvoker: injected execution boundary owned by the SaaS product.
- */
-export interface ToolInvoker {
-    invoke(turnId: string, name: string, args: string, signal?: AbortSignal, invocation?: {
-        callId: string;
-        sessionId: string;
-        round: number;
-    }): Promise<import("../contracts/tool-result.js").ToolResult>;
-}
-/**
- * AgentLogger: structured logging interface.
- * The SaaS service injects its own logging implementation.
- */
-export interface AgentLogger {
-    info(message: string): void;
-    info(obj: Record<string, unknown>, message: string): void;
-    warn(message: string): void;
-    warn(obj: Record<string, unknown>, message: string): void;
-    error(message: string): void;
-    error(obj: Record<string, unknown>, message: string): void;
-    debug(message: string): void;
-    debug(obj: Record<string, unknown>, message: string): void;
-}
-export type { HookRegistry };

package/dist/types/runtime/ports/agent-runtime-ports.d.ts

@@ -1,67 +0,0 @@
-import type { HookRegistry } from "../../contracts/hooks.js";
-import type { OpenAiToolCall } from "./tool-call-contracts.js";
-import type { AgentLogger, ChatMessage, TokenUsage, ToolInvoker } from "./agent-execution-contracts.js";
-export interface RuntimeCompressibleMessage {
-    role: string;
-    content?: string | unknown;
-}
-export interface RuntimeCompressionResult {
-    messages: RuntimeCompressibleMessage[];
-    droppedCount: number;
-    tokensFreed?: number;
-    strategy: string;
-}
-export interface ToolExecutionResultPort {
-    callId: string;
-    toolName: string;
-    ok: boolean;
-    error?: string;
-    blocked?: boolean;
-    blockReason?: string;
-    durationMs?: number;
-    details?: Record<string, unknown>;
-    message: unknown;
-}
-export interface StreamingToolExecutorPort {
-    addTool(toolCall: OpenAiToolCall): void;
-    getRemainingResults(): AsyncIterable<ToolExecutionResultPort>;
-}
-export interface StreamingToolExecutorPortConfig {
-    toolInvoker: ToolInvoker;
-    round?: number;
-    hooks?: HookRegistry;
-    sessionId: string;
-    turnId: string;
-    log: AgentLogger;
-    signal?: AbortSignal;
-    maxConcurrentTools?: number;
-    maxExecutionMs?: number;
-    executionTimeoutMsByTool?: ReadonlyMap<string, number>;
-}
-export interface ToolLoopRuntimePorts {
-    reviewCompletion?(messages: readonly ChatMessage[], answer: string): Promise<ChatMessage[]>;
-    saveCheckpoint?(checkpoint: {
-        turnId: string;
-        sessionId: string;
-        phase: "model_ready" | "tools_pending";
-        messages: ChatMessage[];
-        completedRounds: number;
-        usage: TokenUsage;
-    }): Promise<void>;
-    enforceToolResultBudget(messages: Array<{
-        role: string;
-        content?: string | unknown;
-        tool_call_id?: string;
-    }>): Promise<{
-        messages: unknown[];
-        newlyReplacedCount: number;
-    }>;
-    compressMessages(messages: RuntimeCompressibleMessage[], options: {
-        budget: number;
-        model: string;
-    }): RuntimeCompressionResult;
-    createStreamingToolExecutor(config: StreamingToolExecutorPortConfig): StreamingToolExecutorPort;
-}
-export interface AgentRuntimePorts {
-    toolLoop: ToolLoopRuntimePorts;
-}

package/dist/types/runtime/ports/index.d.ts

@@ -1,5 +0,0 @@
-export { buildToolResultMessage, type OpenAiToolCall, type ToolResultMessageInput } from "./tool-call-contracts.js";
-export type { AgentLogger, ChatMessage, TokenUsage, ToolDefinition, ToolInvoker, TurnEvent } from "./agent-execution-contracts.js";
-export type { AccumulatedToolCall, LLMChunk, LLMRequest, LLMTransport } from "./model-transport-contracts.js";
-export { accumulateToolCalls } from "./model-transport-contracts.js";
-export type { AgentRuntimePorts, RuntimeCompressibleMessage, RuntimeCompressionResult, StreamingToolExecutorPort, StreamingToolExecutorPortConfig, ToolExecutionResultPort, ToolLoopRuntimePorts } from "./agent-runtime-ports.js";

package/dist/types/runtime/ports/tool-call-contracts.d.ts

@@ -1,20 +0,0 @@
-export interface OpenAiToolCall {
-    id: string;
-    type: "function";
-    function: {
-        name: string;
-        arguments: string;
-    };
-}
-export interface ToolResultMessageInput {
-    ok: boolean;
-    payload?: unknown;
-    error?: string;
-    toolReferences?: string[];
-    imageUrls?: string[];
-    contentBlocks?: import("../../contracts/tool-result.js").ToolResult["contentBlocks"];
-    structuredContent?: Record<string, unknown>;
-    mcpMeta?: Record<string, unknown>;
-    mcpIsError?: boolean;
-}
-export declare function buildToolResultMessage(callId: string, result: ToolResultMessageInput): import("../../contracts/chat.js").ChatMessage;