qlogicagent 2.6.1 → 2.9.0

package/dist/types/skills/permissions/hook-runner.d.ts

@@ -4,6 +4,7 @@ import { PermissionRuleEngine } from "./rule-engine.js";
 import type { PermissionUpdate, ApprovalRequest, ApprovalResponse } from "./types.js";
 import { type ClassifierLLMCall } from "./permission-classifier.js";
 import type { PermissionRole } from "../../orchestration/subagent/task-types.js";
+import { DenialAuditLogger } from "./denial-audit-log.js";
 export interface PermissionCheckerDeps {
     ruleEngine: PermissionRuleEngine;
     hookRegistry: HookRegistry;
@@ -35,6 +36,12 @@ export interface PermissionCheckerDeps {
      * - worker: classifier-only path, no approval dialog fallback
      */
     permissionRole?: PermissionRole;
+    /** Denial audit logger for persistent audit trail. */
+    auditLogger?: DenialAuditLogger;
+    /** Current session ID (for audit context). */
+    sessionId?: string;
+    /** Getter for current turn ID (changes per turn). */
+    getTurnId?: () => string;
 }
 export declare class PermissionChecker {
     private readonly ruleEngine;
@@ -46,12 +53,15 @@ export declare class PermissionChecker {
     private readonly getRecentMessages;
     private readonly permissionRole;
     private readonly pendingApprovals;
+    private readonly auditLogger;
+    private readonly sessionId;
+    private readonly getTurnId;
     private unregisterHook;
-    /** Tool meta cache 鈥?populated from ToolDefinition[] at agent creation */
+    /** Tool meta cache — populated from ToolDefinition[] at agent creation */
     private toolMetaCache;
-    /** Classifier result cache 鈥?avoids redundant LLM calls (CC permissionCache parity) */
+    /** Classifier result cache — avoids redundant LLM calls (CC permissionCache parity) */
     private classifierCache;
-    /** Denial tracking state 鈥?CC denialTracking.ts parity */
+    /** Denial tracking state — CC denialTracking.ts parity */
     private denialTracking;
     constructor(deps: PermissionCheckerDeps);
     /**
@@ -68,7 +78,7 @@ export declare class PermissionChecker {
      */
     setToolMeta(tools: ToolDefinition[]): void;
     get ruleEngineRef(): PermissionRuleEngine;
-    /** Fire permission.denied hook + onDenied callback */
+    /** Fire permission.denied hook + onDenied callback + audit log */
     private fireDenied;
     private handleResult;
     /**

package/dist/types/skills/permissions/permission-classifier.d.ts

@@ -6,7 +6,7 @@ export interface ClassifierResult {
     durationMs: number;
 }
 /**
- * LLM call interface 鈥?injected by the host so the classifier
+ * LLM call interfaceinjected by the host so the classifier
  * doesn't depend on a specific LLM client.
  */
 export interface ClassifierLLMCall {

package/dist/types/skills/skill-system/skill-lifecycle.d.ts

@@ -0,0 +1,81 @@
+export type SkillLifecycleState = "active" | "stale" | "archived";
+export interface SkillLifecycleRecord {
+    name: string;
+    state: SkillLifecycleState;
+    createdAt: string;
+    lastUsedAt?: string;
+    lastViewedAt?: string;
+    lastPatchedAt?: string;
+    staleAt?: string;
+    archivedAt?: string;
+    pinned: boolean;
+    useCount: number;
+    source: "learned" | "created" | "installed" | "promoted";
+}
+export interface SkillLifecycleStore {
+    version: 1;
+    records: Record<string, SkillLifecycleRecord>;
+}
+export interface CuratorResult {
+    transitioned: Array<{
+        name: string;
+        from: SkillLifecycleState;
+        to: SkillLifecycleState;
+    }>;
+    skippedPinned: string[];
+}
+export declare function loadLifecycleStore(agentHome: string): SkillLifecycleStore;
+export declare function saveLifecycleStore(agentHome: string, store: SkillLifecycleStore): void;
+/**
+ * Ensure a lifecycle record exists for a skill. Creates one if missing.
+ */
+export declare function ensureRecord(store: SkillLifecycleStore, name: string, source?: SkillLifecycleRecord["source"]): SkillLifecycleRecord;
+/**
+ * Record a skill invocation — resets to active if stale.
+ */
+export declare function recordInvocation(store: SkillLifecycleStore, name: string): void;
+/**
+ * Record that a skill was viewed/listed.
+ */
+export declare function recordView(store: SkillLifecycleStore, name: string): void;
+/**
+ * Record that a skill was edited/patched.
+ */
+export declare function recordPatch(store: SkillLifecycleStore, name: string): void;
+export declare function pinSkill(store: SkillLifecycleStore, name: string): boolean;
+export declare function unpinSkill(store: SkillLifecycleStore, name: string): boolean;
+export declare function isPinned(store: SkillLifecycleStore, name: string): boolean;
+/**
+ * Run curator evaluation on all skills. Transitions states based on inactivity.
+ * Pinned skills are never transitioned.
+ *
+ * Call this on agent idle, periodic timer, or explicit RPC.
+ */
+export declare function runCurator(store: SkillLifecycleStore): CuratorResult;
+/**
+ * Archive a skill on disk: move its directory to `.archive/` subfolder.
+ * Returns true if archival succeeded.
+ */
+export declare function archiveSkillOnDisk(skillsDir: string, skillName: string): boolean;
+/**
+ * Unarchive a skill: move from `.archive/` back to main skills dir.
+ * Resets state to active.
+ */
+export declare function unarchiveSkillOnDisk(skillsDir: string, skillName: string): boolean;
+/**
+ * Execute full curator cycle: evaluate state transitions + archive on disk.
+ * Returns curator result with all transitions made.
+ */
+export declare function executeCuratorCycle(agentHome: string, skillsDir: string): CuratorResult;
+/**
+ * Get all skills in a given state.
+ */
+export declare function getSkillsByState(store: SkillLifecycleStore, state: SkillLifecycleState): SkillLifecycleRecord[];
+/**
+ * Get lifecycle record for a skill. Returns undefined if not tracked.
+ */
+export declare function getLifecycleRecord(store: SkillLifecycleStore, name: string): SkillLifecycleRecord | undefined;
+/**
+ * Remove a lifecycle record (e.g., when skill is deleted).
+ */
+export declare function removeRecord(store: SkillLifecycleStore, name: string): void;

package/dist/types/skills/skill-system/skill-validation.d.ts

@@ -0,0 +1,29 @@
+export interface FrontmatterValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    /** Parsed frontmatter if valid. */
+    parsed?: Record<string, string>;
+}
+/**
+ * Validate SKILL.md content for required frontmatter structure.
+ * Used before persisting agent-created skills.
+ */
+export declare function validateSkillContent(content: string, expectedName?: string): FrontmatterValidationResult;
+/**
+ * Generate valid SKILL.md content with proper frontmatter from minimal inputs.
+ * Used when auto-persisting skills from skill_instruction events.
+ */
+export declare function generateSkillContent(params: {
+    name: string;
+    description: string;
+    tools?: string[];
+    body: string;
+    version?: string;
+    category?: string;
+}): string;
+/**
+ * Auto-fix common frontmatter issues in LLM-generated skill content.
+ * Returns fixed content or null if unfixable.
+ */
+export declare function autoFixFrontmatter(content: string, name: string, description?: string): string | null;

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

@@ -14,7 +14,7 @@ export declare const EXEC_TOOL_SCHEMA: {
     readonly properties: {
         readonly command: {
             readonly type: "string";
-            readonly description: "Shell command to execute. On Windows uses PowerShell, on Unix uses bash.";
+            readonly description: "Shell command to execute in PowerShell." | "Shell command to execute in bash. Use Unix-style commands (ls, cat, mkdir -p, etc.).";
         };
         readonly description: {
             readonly type: "string";

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

@@ -87,7 +87,7 @@ export interface SearchToolDeps {
      * The implementation may use ripgrep, native grep, or a custom engine.
      * Returns match records.
      * The host SHOULD auto-exclude VCS directories (.git, .svn, .hg, .bzr)
-     * and enforce --max-columns 500 to avoid minified file noise.
+     * and enforcemax-columns 500 to avoid minified file noise.
      */
     grep(pattern: string, options: {
         cwd: string;

package/dist/types/skills/tools.d.ts

@@ -1,5 +1,5 @@
 /**
- * Tool Registry 鈥?CC-aligned getAllBaseTools() pattern.
+ * Tool RegistryCC-aligned getAllBaseTools() pattern.
  *
  * CC reference: claude-code-haha/src/tools.ts
  *
@@ -52,7 +52,7 @@ export declare function getToolCount(): number;
  */
 export declare function executeTool(name: string, toolCallId: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<import("./portable-tool.js").PortableToolResult>;
 /**
- * CC: getTools() 鈥?return all enabled tools.
+ * CC: getTools()return all enabled tools.
  * Filters the pool by isEnabled() gate; disabled tools are invisible to callers.
  * CC reference: claude-code-haha/src/tools.ts getTools()
  */
@@ -73,7 +73,7 @@ export declare function isToolActivated(name: string): boolean;
 export declare function clearActivatedTools(): void;
 /**
  * Generate ToolDefinition[] manifest for LLM tool_use.
- * Filters by isEnabled() 鈥?disabled tools never reach the model.
+ * Filters by isEnabled()disabled tools never reach the model.
  * Deferred tools are excluded UNLESS they have been activated via tool_search.
  * CC: getTools() + manifest generation combined.
  */

package/dist/types/transport/acp-event-emitter.d.ts

@@ -1,5 +1,5 @@
 /**
- * ACP Event Emitter 鈥?translates internal qlogicagent notifications to ACP
+ * ACP Event Emittertranslates internal qlogicagent notifications to ACP
  * session/update notifications.
  *
  * Maps the 47+ internal notification methods (turn.delta, turn.tool_call, etc.)

package/dist/types/transport/acp-server.d.ts

@@ -1,5 +1,5 @@
 /**
- * ACP Server 鈥?Agent-Client Protocol server layer for qlogicagent.
+ * ACP ServerAgent-Client Protocol server layer for qlogicagent.
  *
  * This module implements qlogicagent as an ACP Server, allowing any ACP-compliant
  * host (AionUI, Cursor, openclaw, etc.) to connect and interact with the agent.
@@ -60,7 +60,12 @@ export interface AcpRequestHandler {
     handleAcpSoloSelect(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloCancel(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloSubscribe(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpSoloMessage(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpSoloEvaluate(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductCreate(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductPlan(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductConfirm(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductMessage(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductPause(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductResume(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductCancel(params: Record<string, unknown>): Promise<unknown>;
@@ -73,7 +78,7 @@ export interface AcpServerConfig {
     verbose?: boolean;
 }
 /**
- * AcpServer 鈥?manages the ACP protocol state machine.
+ * AcpServermanages the ACP protocol state machine.
  *
  * Lifecycle:
  * 1. Host connects (stdio)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.6.1",
+  "version": "2.9.0",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -34,10 +34,18 @@
   ],
   "typesVersions": {
     "*": {
-      "protocol": ["./dist/types/protocol/wire/index.d.ts"],
-      "agent": ["./dist/types/agent/agent.d.ts"],
-      "contracts": ["./dist/types/contracts/index.d.ts"],
-      "orchestration": ["./dist/types/orchestration/index.d.ts"]
+      "protocol": [
+        "./dist/types/protocol/wire/index.d.ts"
+      ],
+      "agent": [
+        "./dist/types/agent/agent.d.ts"
+      ],
+      "contracts": [
+        "./dist/types/contracts/index.d.ts"
+      ],
+      "orchestration": [
+        "./dist/types/orchestration/index.d.ts"
+      ]
     }
   },
   "scripts": {
@@ -54,12 +62,18 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
+    "@qlogic/provider-core": "workspace:*",
+    "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
     "nanoid": "^5.1.5",
     "pino": "^9.6.0",
     "pino-pretty": "^13.0.0"
   },
+  "optionalDependencies": {
+    "@xenova/transformers": "^2.17.2"
+  },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.15.0",
     "esbuild": "^0.28.0",
     "tsx": "^4.19.0",

package/dist/types/llm/adapters/aliyun-oss-file-upload-adapter.d.ts

@@ -1,44 +0,0 @@
-/**
- * Aliyun OSS File Upload Adapter — direct upload to Alibaba Cloud OSS.
- *
- * Uploads files directly to OSS bucket using V1 signature (HMAC-SHA1).
- * No external dependencies — uses Node.js crypto + fetch.
- *
- * This is the **universal fallback adapter** for providers without a native
- * File Upload API (e.g. Anthropic). Ensures ALL file handling goes through
- * upload — never base64 inline.
- *
- * Environment variables:
- *   OSS_ACCESS_KEY_ID       — Aliyun AccessKey ID
- *   OSS_ACCESS_KEY_SECRET   — Aliyun AccessKey Secret
- *   OSS_BUCKET              — Bucket name (default: "qlogicagent")
- *   OSS_REGION              — Region (default: "cn-beijing")
- *   OSS_ENDPOINT            — Custom endpoint (default: derived from region)
- */
-import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
-export interface AliyunOSSFileUploadConfig {
-    /** Aliyun AccessKey ID. Required. */
-    accessKeyId: string;
-    /** Aliyun AccessKey Secret. Required. */
-    accessKeySecret: string;
-    /** OSS Bucket name. Default: "qlogicagent". */
-    bucket?: string;
-    /** OSS Region. Default: "cn-beijing". */
-    region?: string;
-    /** Custom OSS endpoint. Default: "{bucket}.oss-{region}.aliyuncs.com". */
-    endpoint?: string;
-    /** Upload path prefix. Default: "media". */
-    pathPrefix?: string;
-    /** Timeout ms. Default: 120_000. */
-    timeoutMs?: number;
-}
-/**
- * Create an AliyunOSSFileUploadAdapter from environment variables.
- * Returns undefined if required env vars (OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET) are missing.
- */
-export declare function createAliyunOSSAdapterFromEnv(): AliyunOSSFileUploadAdapter | undefined;
-export declare class AliyunOSSFileUploadAdapter implements FileUploadAdapter {
-    private readonly config;
-    constructor(config: AliyunOSSFileUploadConfig);
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, _apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-}

package/dist/types/llm/adapters/gemini-file-upload-adapter.d.ts

@@ -1,26 +0,0 @@
-/**
- * Gemini File Upload Adapter.
- *
- * Implements the Google Gemini 2-step resumable upload protocol
- * into the unified FileUploadAdapter interface.
- *
- * Protocol:
- *   1. POST /upload/v1beta/files — initiate, get upload URL
- *   2. PUT {uploadUrl} — send bytes, finalize
- *
- * Returns a file URI (e.g. "files/abc123") that can be used in
- * generateContent requests as a file reference.
- */
-import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
-export interface GeminiFileUploadConfig {
-    /** Base URL (e.g. "https://generativelanguage.googleapis.com/v1beta") */
-    baseUrl: string;
-    /** Timeout ms. Default: 180_000. */
-    timeoutMs?: number;
-}
-export declare class GeminiFileUploadAdapter implements FileUploadAdapter {
-    private readonly config;
-    constructor(config: GeminiFileUploadConfig);
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-    private waitForProcessing;
-}

package/dist/types/llm/adapters/hub-oss-file-upload-adapter.d.ts

@@ -1,29 +0,0 @@
-/**
- * Hub OSS File Upload Adapter — for providers without native File API (e.g. Anthropic).
- *
- * Uploads local files to the Hub's OSS relay endpoint, which stores them in
- * cloud object storage (Aliyun OSS / Tencent COS) and returns a public URL.
- * The LLM provider can then access the file via this public URL.
- *
- * This enables Anthropic (which only supports base64 inline or public URL)
- * to handle large files that exceed the base64 size limit (20MB).
- *
- * Endpoint: POST {hubBaseUrl}/api/v1/files/upload
- * Returns: { url: "https://oss-bucket.oss-cn-xxx.aliyuncs.com/..." }
- */
-import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
-export interface HubOSSFileUploadConfig {
-    /** Hub API base URL (e.g. "https://hub.xiaozhiclaw.com" or from env). */
-    hubBaseUrl: string;
-    /** Hub API key for authentication. */
-    hubApiKey?: string;
-    /** Timeout ms. Default: 120_000. */
-    timeoutMs?: number;
-    /** Provider name for result metadata. Default: "hub-oss". */
-    provider?: string;
-}
-export declare class HubOSSFileUploadAdapter implements FileUploadAdapter {
-    private readonly config;
-    constructor(config: HubOSSFileUploadConfig);
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, _apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-}

package/dist/types/llm/adapters/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * File Upload Adapters — barrel export.
- *
- * Provider-specific implementations of the FileUploadAdapter interface.
- */
-export { OpenAIFileUploadAdapter, type OpenAIFileUploadConfig } from "./openai-file-upload-adapter.js";
-export { VolcengineFileUploadAdapter, type VolcengineFileUploadConfig } from "./volcengine-file-upload-adapter.js";
-export { GeminiFileUploadAdapter, type GeminiFileUploadConfig } from "./gemini-file-upload-adapter.js";
-export { HubOSSFileUploadAdapter, type HubOSSFileUploadConfig } from "./hub-oss-file-upload-adapter.js";
-export { AliyunOSSFileUploadAdapter, type AliyunOSSFileUploadConfig, createAliyunOSSAdapterFromEnv } from "./aliyun-oss-file-upload-adapter.js";

package/dist/types/llm/adapters/openai-file-upload-adapter.d.ts

@@ -1,38 +0,0 @@
-/**
- * OpenAI-compatible File Upload Adapter.
- *
- * Implements FileUploadAdapter for providers using the standard
- * POST /v1/files multipart upload endpoint:
- *   - OpenAI
- *   - Kimi (Moonshot)
- *   - Minimax
- *   - Qwen (via DashScope compatible endpoint)
- *   - GLM (Zhipu)
- *   - Any OpenAI-API-compatible provider
- *
- * The uploaded file gets a file_id which can be referenced in messages.
- * Some providers also return a direct download URL.
- */
-import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
-export interface OpenAIFileUploadConfig {
-    /** Base URL (e.g. "https://api.openai.com/v1" or "https://api.moonshot.cn/v1") */
-    baseUrl: string;
-    /** Provider name for result metadata. */
-    provider: string;
-    /** Extra headers to include (e.g. for Minimax group_id). */
-    extraHeaders?: Record<string, string>;
-    /** Upload purpose (default: "file-extract" for document understanding). */
-    defaultPurpose?: string;
-    /**
-     * Whether the provider returns a download URL in the upload response.
-     * If false, constructs URL from file_id (provider-specific).
-     */
-    returnsUrl?: boolean;
-    /** Timeout for upload request (ms). Default: 120_000. */
-    timeoutMs?: number;
-}
-export declare class OpenAIFileUploadAdapter implements FileUploadAdapter {
-    private readonly config;
-    constructor(config: OpenAIFileUploadConfig);
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-}

package/dist/types/llm/adapters/volcengine-file-upload-adapter.d.ts

@@ -1,24 +0,0 @@
-/**
- * Volcengine File Upload Adapter.
- *
- * Wraps the Volcengine /v3/files endpoint into the unified
- * FileUploadAdapter interface.
- *
- * Volcengine returns a file_id that can be used in API messages
- * as a file reference. Files uploaded this way can be referenced in
- * multimodal inputs via the file_id field.
- */
-import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
-export interface VolcengineFileUploadConfig {
-    /** Base URL (e.g. "https://ark.cn-beijing.volces.com/api") */
-    baseUrl: string;
-    /** Upload purpose. Default: "user_data". */
-    defaultPurpose?: string;
-    /** Timeout ms. Default: 120_000. */
-    timeoutMs?: number;
-}
-export declare class VolcengineFileUploadAdapter implements FileUploadAdapter {
-    private readonly config;
-    constructor(config: VolcengineFileUploadConfig);
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-}

package/dist/types/llm/builtin-providers.d.ts

@@ -1,10 +0,0 @@
-/**
- * Builtin provider definitions — hardcoded fallback list (~30 providers).
- *
- * This is Layer 1 (lowest priority) of the three-layer merge strategy.
- * Used when remote model catalog is unavailable.
- *
- * Aligned with Hermes hermes_cli/models.py hardcoded fallback.
- */
-import type { ProviderDef } from "./provider-def.js";
-export declare const BUILTIN_PROVIDERS: ProviderDef[];

package/dist/types/llm/debug-transport.d.ts

@@ -1,12 +0,0 @@
-import type { LLMTransport } from "./transport.js";
-/**
- * Check whether debug transport should be enabled.
- */
-export declare function isDebugTransportEnabled(): boolean;
-/**
- * Create a DebugTransport decorator that wraps a base LLMTransport,
- * logging request metadata + timing + usage to JSONL.
- *
- * CC parity: createDumpPromptsFetch — but vendor-agnostic via transport abstraction.
- */
-export declare function createDebugTransport(base: LLMTransport, sessionId: string): LLMTransport;

package/dist/types/llm/file-upload-service.d.ts

@@ -1,68 +0,0 @@
-/**
- * FileUploadService — Unified file upload abstraction for all LLM providers.
- *
- * Replaces the base64 approach in media-resolve.ts. When a local URL is
- * encountered, this service uploads the file to the current provider's
- * File API and returns a public URL or file_id.
- *
- * Supported providers:
- *   - OpenAI-compatible (OpenAI, Kimi, Minimax, Qwen, GLM) — POST /v1/files
- *   - Volcengine — POST /v3/files
- *   - Google Gemini — Resumable upload protocol
- *
- * Architecture:
- *   Transport layer calls resolveLocalMedia() before sending messages.
- *   resolveLocalMedia() fetches local content and uploads to provider,
- *   returning a public URL the LLM can access.
- */
-export interface FileUploadResult {
-    /** Public URL accessible by the LLM provider. */
-    url: string;
-    /** Provider-specific file identifier (for reference/deletion). */
-    fileId: string;
-    /** Original filename. */
-    filename: string;
-    /** File size in bytes. */
-    bytes: number;
-    /** MIME type of the uploaded file. */
-    mimeType: string;
-    /** Provider that stored the file. */
-    provider: string;
-}
-/**
- * Provider-specific upload adapter.
- * Each transport implements this to upload files to its own File API.
- */
-export interface FileUploadAdapter {
-    /**
-     * Upload a file buffer and return a publicly accessible URL.
-     * @param buffer - File content
-     * @param filename - Original filename (used for MIME detection)
-     * @param mimeType - MIME type of the file
-     * @param apiKey - Provider API key
-     * @param signal - Abort signal
-     */
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-}
-/** Guess MIME type from filename extension. */
-export declare function guessMimeType(filename: string): string;
-/** Check if a URL points to a local/private address that cloud APIs cannot reach. */
-export declare function isLocalUrl(url: string): boolean;
-/**
- * Resolve a local URL by uploading its content to the provider's File API.
- * Public URLs are returned as-is (the LLM API can fetch them directly).
- *
- * @param url - The URL to resolve (may be local or public)
- * @param adapter - Provider-specific upload adapter
- * @param apiKey - API key for the upload
- * @param signal - Optional abort signal
- * @returns Public URL accessible by the LLM
- */
-export declare function resolveLocalMedia(url: string, adapter: FileUploadAdapter, apiKey: string, signal?: AbortSignal): Promise<string>;
-/**
- * Batch-resolve multiple URLs concurrently. Returns array in same order.
- * Local URLs are uploaded; public URLs pass through unchanged.
- * Supports concurrent uploads (up to `concurrency` limit, default 3).
- * Failures throw (caller should handle).
- */
-export declare function resolveLocalMediaBatch(urls: string[], adapter: FileUploadAdapter, apiKey: string, signal?: AbortSignal, concurrency?: number): Promise<string[]>;

package/dist/types/llm/gemini-schema-utils.d.ts

@@ -1,17 +0,0 @@
-/**
- * Gemini JSON Schema cleaning utilities.
- *
- * Gemini's generateContent API rejects several standard JSON Schema keywords.
- * This module provides a shared recursive cleaner used by:
- *   - GeminiGenerateContentTransport (tool declarations in request body)
- *   - tool-schema.ts (provider-aware schema normalization at orchestration level)
- *
- * Keeping a single source of truth avoids drift between the two consumers.
- */
-/** Keywords that Gemini's generateContent API does not accept in tool schemas. */
-export declare const GEMINI_UNSUPPORTED_SCHEMA_KEYWORDS: Set<string>;
-/**
- * Recursively strip unsupported JSON Schema keywords from a schema object.
- * Safe to call multiple times (idempotent).
- */
-export declare function cleanSchemaForGemini(schema: unknown): unknown;

package/dist/types/llm/llm-client.d.ts

@@ -1,43 +0,0 @@
-/**
- * LLM Client factory — resolves ProviderDef → creates LLMTransport instance.
- *
- * Replaces the old createAdminInferProxyClient() call chain.
- * User API key + ProviderDef → direct provider connection.
- */
-import type { ProviderDef } from "./provider-def.js";
-import type { LLMTransport } from "./transport.js";
-import { ProviderRegistry } from "./provider-registry.js";
-export interface LLMClientConfig {
-    /** Provider id, e.g. "deepseek" */
-    provider: string;
-    /** Model id, e.g. "deepseek-v4-flash" */
-    model: string;
-    /** User API key */
-    apiKey: string;
-    /** Optional base URL override */
-    baseUrl?: string;
-}
-export interface LLMClient {
-    transport: LLMTransport;
-    apiKey: string;
-    resolvedModel: string;
-    providerDef: ProviderDef;
-}
-/**
- * Create an LLM client from config + registry.
- *
- * 1. Look up provider in registry
- * 2. Apply baseUrl override if provided
- * 3. Instantiate the correct transport
- */
-export declare function createLLMClient(config: LLMClientConfig, registry: ProviderRegistry): LLMClient;
-/**
- * Auto-detect provider from API key environment variables.
- * Scans registry for providers whose env vars are set.
- * Returns the first match.
- */
-export declare function autoDetectProvider(registry: ProviderRegistry): {
-    providerId: string;
-    apiKey: string;
-    defaultModel: string;
-} | undefined;