qlogicagent 0.5.3 → 1.0.0

package/dist/types/orchestration/team-tool-loop-wiring.d.ts

@@ -1,92 +0,0 @@
-/**
- * Team Tool Loop Wiring — Connects team orchestration to the tool loop.
- *
- * When the LLM invokes `team_create`, this module:
- * 1. Validates the team plan
- * 2. Maps team agents to fork contexts
- * 3. Coordinates execution according to the team execution mode
- * 4. Aggregates results according to the aggregation policy
- * 5. Returns the aggregated result as a tool_result
- *
- * This bridges the gap between the pure strategy layer (team-orchestration.ts)
- * and the Hub's tool loop.
- */
-import type { AgentRole, TeamExecutionMode, TeamAggregationPolicy, TeamLifecycleState } from "./team-orchestration.js";
-import type { AgentDefinition } from "./agent-registry.js";
-import type { ForkResult } from "./fork-subagent.js";
-export interface TeamToolRequest {
-    /** Team name for identification. */
-    name: string;
-    /** Agent specs for the team. */
-    agents: TeamAgentRequest[];
-    /** Execution mode. */
-    mode: TeamExecutionMode;
-    /** How to aggregate results. */
-    aggregation: TeamAggregationPolicy;
-}
-export interface TeamAgentRequest {
-    /** Role within the team. */
-    role: AgentRole;
-    /** Agent type from built-in registry. */
-    agentType: string;
-    /** Task prompt for this agent. */
-    prompt: string;
-    /** Max turns override. */
-    maxTurns?: number;
-    /** Dependencies (agent IDs that must complete before this one). */
-    dependsOn?: string[];
-}
-export interface TeamExecutionPlan {
-    /** Ordered batches for execution. */
-    batches: TeamExecutionBatch[];
-    /** Total estimated token budget. */
-    totalBudget: number;
-    /** Lifecycle state. */
-    state: TeamLifecycleState;
-}
-export interface TeamExecutionBatch {
-    /** Agents in this batch (run in parallel within a batch). */
-    agents: TeamAgentRequest[];
-    /** Batch mode (parallel or sequential within the batch). */
-    mode: "parallel" | "serial";
-}
-/**
- * Resolve the execution plan for a team request.
- * Validates the request, resolves dependencies into ordered batches,
- * and determines the execution topology.
- */
-export declare function resolveTeamExecutionPlan(request: TeamToolRequest): TeamExecutionPlan;
-export interface TeamAggregatedResult {
-    /** Whether the team execution succeeded overall. */
-    ok: boolean;
-    /** Aggregated output text. */
-    output: string;
-    /** Individual agent results. */
-    agentResults: Array<{
-        agentId: string;
-        role: AgentRole;
-        result: ForkResult;
-    }>;
-    /** Total tokens consumed by all agents. */
-    totalTokensUsed: number;
-    /** Lifecycle state after aggregation. */
-    finalState: TeamLifecycleState;
-}
-/**
- * Aggregate results from team agents according to the aggregation policy.
- */
-export declare function aggregateTeamToolResults(results: Array<{
-    agentId: string;
-    role: AgentRole;
-    result: ForkResult;
-}>, policy: TeamAggregationPolicy): TeamAggregatedResult;
-/**
- * Map a team tool_call into the format needed for the tool loop to dispatch.
- * Returns the list of fork configs the tool loop should execute.
- */
-export declare function mapTeamRequestToForkConfigs(request: TeamToolRequest, agentRegistry: (name: string) => AgentDefinition | undefined): Array<{
-    agentDef: AgentDefinition;
-    prompt: string;
-    maxTurns?: number;
-    role: AgentRole;
-}>;

package/dist/types/skills/memory-query-tool.d.ts

@@ -1,43 +0,0 @@
-import type { PortableTool } from "./portable-tool.js";
-export declare const MEMORY_QUERY_TOOL_NAME: "memory_query";
-export declare const MEMORY_QUERY_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly query: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly category: {
-            readonly type: "string";
-            readonly description: string;
-        };
-    };
-    readonly required: readonly ["query"];
-};
-export interface MediaPreferencesSummary {
-    imageStyle?: string;
-    videoStyle?: string;
-    musicGenre?: string;
-    musicMood?: string;
-    primaryPurpose?: string;
-    colorPreference?: string;
-}
-/**
- * Dependency-injected callbacks for memory query.
- * Consumers provide these from their own memory system.
- */
-export interface MemoryQueryToolDeps {
-    /** Query recalled facts/memories by natural language. */
-    queryGraph?: (query: string, userId: string) => string[];
-    /** Retrieve user profile summary. */
-    getProfileSummary?: (userId: string) => string | null;
-    /** Retrieve media preferences. */
-    getMediaPreferences?: (userId: string) => MediaPreferencesSummary | null;
-    /** User ID for this session. */
-    userId?: string;
-}
-export interface MemoryQueryToolParams {
-    query: string;
-    category?: string;
-}
-export declare function createMemoryQueryTool(deps?: MemoryQueryToolDeps): PortableTool<MemoryQueryToolParams>;

package/dist/types/skills/tool-registry.d.ts

@@ -1,29 +0,0 @@
-import type { PortableTool, PortableToolResult } from "./portable-tool.js";
-import type { ToolDefinition } from "../agent/types.js";
-export declare class ToolRegistry {
-    private tools;
-    /** Register a single tool. Overwrites if name already exists. */
-    register(tool: PortableTool<any>): void;
-    /** Register multiple tools at once. */
-    registerAll(tools: PortableTool<any>[]): void;
-    /** Unregister a tool by name. */
-    unregister(name: string): boolean;
-    /** Find a tool by name. Returns undefined if not registered. */
-    findTool(name: string): PortableTool | undefined;
-    /** Check if a tool is registered locally. */
-    has(name: string): boolean;
-    /**
-     * Execute a tool by name.
-     * @throws Error if the tool is not registered.
-     */
-    execute(name: string, toolCallId: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<PortableToolResult>;
-    /**
-     * Generate ToolDefinition[] manifest for LLM tool_use.
-     * Excludes deferred tools by default.
-     */
-    getToolManifest(includeDeferred?: boolean): ToolDefinition[];
-    /** Get all registered tool names. */
-    getToolNames(): string[];
-    /** Number of registered tools. */
-    get size(): number;
-}

package/dist/types/skills/tools/memory-tool.d.ts

@@ -1,74 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const MEMORY_SEARCH_TOOL_NAME: "memory_search";
-export type MemorySource = "memory" | "sessions" | "all";
-export interface MemorySearchToolParams {
-    /** Search query */
-    query: string;
-    /** Source to search in */
-    source?: MemorySource;
-    /** Maximum results to return */
-    maxResults?: number;
-    /** Filter by time range (ISO date string, sessions only) */
-    after?: string;
-    /** Filter by time range (ISO date string, sessions only) */
-    before?: string;
-}
-export declare const MEMORY_SEARCH_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly query: {
-            readonly type: "string";
-            readonly description: "Search query. Supports natural language and keywords.";
-        };
-        readonly source: {
-            readonly type: "string";
-            readonly enum: readonly ["memory", "sessions", "all"];
-            readonly description: string;
-        };
-        readonly maxResults: {
-            readonly type: "number";
-            readonly description: "Maximum results to return (default: 5).";
-        };
-        readonly after: {
-            readonly type: "string";
-            readonly description: "Only return sessions after this date (ISO format). Sessions source only.";
-        };
-        readonly before: {
-            readonly type: "string";
-            readonly description: "Only return sessions before this date (ISO format). Sessions source only.";
-        };
-    };
-    readonly required: readonly ["query"];
-};
-export interface MemoryEntry {
-    content: string;
-    source: "memory" | "session";
-    relevance: number;
-    metadata?: {
-        sessionId?: string;
-        timestamp?: string;
-        summary?: string;
-    };
-}
-export interface MemoryQueryOutput {
-    results: MemoryEntry[];
-    query: string;
-    sources: MemorySource[];
-}
-/**
- * Host-provided memory search backend.
- */
-export interface MemorySearchToolDeps {
-    /**
-     * Search memory/sessions.
-     * The host routes to QMemory vector search, FTS session search, or both.
-     */
-    searchMemory(params: {
-        query: string;
-        source: MemorySource;
-        maxResults: number;
-        after?: string;
-        before?: string;
-    }): Promise<MemoryQueryOutput>;
-}
-export declare function createMemorySearchTool(deps: MemorySearchToolDeps): PortableTool<MemorySearchToolParams>;

package/dist/types/skills/tools/pdf-tool.d.ts

@@ -1,66 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const PDF_TOOL_NAME: "pdf";
-export interface PdfToolParams {
-    prompt?: string;
-    pdf?: string;
-    pdfs?: string[];
-    pages?: string;
-}
-export declare const PDF_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly prompt: {
-            readonly type: "string";
-            readonly description: "Describe what to analyze or extract from the PDF(s).";
-        };
-        readonly pdf: {
-            readonly type: "string";
-            readonly description: "Single PDF path or URL.";
-        };
-        readonly pdfs: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly description: "Multiple PDF paths or URLs (up to 10).";
-        };
-        readonly pages: {
-            readonly type: "string";
-            readonly description: "Page range to process, e.g. \"1-5\", \"1,3,5-7\". Defaults to all pages.";
-        };
-    };
-    readonly required: readonly [];
-};
-/** Deps injected by the host runtime for PDF analysis. */
-export interface PdfToolDeps {
-    /**
-     * Extract text and/or page images from a PDF.
-     * The host decides how to load (local FS, HTTP, etc.).
-     */
-    extractPdf(source: string, options?: {
-        pages?: string;
-    }): Promise<{
-        text: string;
-        pageImages?: Array<{
-            page: number;
-            base64: string;
-            mimeType: string;
-        }>;
-    }>;
-    /**
-     * Optional: analyze extracted content via LLM.
-     * If not provided, the tool returns raw extracted text.
-     */
-    analyzePdfContent?(prompt: string, content: {
-        text: string;
-        images?: Array<{
-            base64: string;
-            mimeType: string;
-        }>;
-    }): Promise<{
-        text: string;
-        model?: string;
-        provider?: string;
-    }>;
-}
-export declare function createPdfTool(deps: PdfToolDeps): PortableTool<PdfToolParams>;