comisai 1.0.24 → 1.0.26

package/node_modules/@comis/skills/dist/builtin/platform/providers-manage-tool.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Provider management tool: multi-action tool for LLM provider configuration.
+ *
+ * Supports 7 actions: list, get, create, update, delete, enable, disable.
+ * Destructive actions (create, delete) require approval via the ApprovalGate.
+ * All actions enforce admin trust level via createTrustGuard.
+ * Delegates to providers.* RPC handlers via rpcCall.
+ *
+ * @module
+ */
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { ApprovalGate } from "@comis/core";
+import type { RpcCall } from "./cron-tool.js";
+export declare const ProvidersManageToolParams: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"get">, import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"update">, import("@sinclair/typebox").TLiteral<"delete">, import("@sinclair/typebox").TLiteral<"enable">, import("@sinclair/typebox").TLiteral<"disable">]>;
+    provider_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    config: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        baseUrl: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        apiKeyName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        enabled: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        timeoutMs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        maxRetries: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        headers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TString>>;
+        models: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            id: import("@sinclair/typebox").TString;
+            name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            reasoning: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+            contextWindow: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+            maxTokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+            input: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"text">, import("@sinclair/typebox").TLiteral<"image">]>>>;
+        }>>>;
+    }>, import("@sinclair/typebox").TString]>>;
+}>;
+/**
+ * Create a provider management tool with 7 actions.
+ *
+ * Actions:
+ * - **list** -- List all configured providers
+ * - **get** -- Get provider configuration and status
+ * - **create** -- Register a new provider (requires approval)
+ * - **update** -- Modify provider configuration
+ * - **delete** -- Remove a provider (requires approval)
+ * - **enable** -- Enable a disabled provider
+ * - **disable** -- Disable a provider
+ *
+ * @param rpcCall - RPC call function for delegating to the daemon backend
+ * @param approvalGate - Optional approval gate for create/delete actions
+ * @param callbacks - Optional mutation lifecycle callbacks (onMutationStart/onMutationEnd)
+ * @returns AgentTool implementing the provider management interface
+ */
+export declare function createProvidersManageTool(rpcCall: RpcCall, approvalGate?: ApprovalGate, callbacks?: {
+    onMutationStart?: () => void;
+    onMutationEnd?: () => void;
+}): AgentTool<typeof ProvidersManageToolParams>;

package/node_modules/@comis/skills/dist/builtin/platform/providers-manage-tool.js

@@ -0,0 +1,203 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Provider management tool: multi-action tool for LLM provider configuration.
+ *
+ * Supports 7 actions: list, get, create, update, delete, enable, disable.
+ * Destructive actions (create, delete) require approval via the ApprovalGate.
+ * All actions enforce admin trust level via createTrustGuard.
+ * Delegates to providers.* RPC handlers via rpcCall.
+ *
+ * @module
+ */
+import { Type } from "@sinclair/typebox";
+import { readStringParam } from "./tool-helpers.js";
+import { createAdminManageTool } from "./admin-manage-factory.js";
+// ---------------------------------------------------------------------------
+// Parameter schema
+// ---------------------------------------------------------------------------
+export const ProvidersManageToolParams = Type.Object({
+    action: Type.Union([
+        Type.Literal("list"),
+        Type.Literal("get"),
+        Type.Literal("create"),
+        Type.Literal("update"),
+        Type.Literal("delete"),
+        Type.Literal("enable"),
+        Type.Literal("disable"),
+    ], {
+        description: "Provider management action. Valid values: " +
+            "list (view all providers), get (read config), " +
+            "create (register new provider), update (modify config), " +
+            "delete (remove provider), enable/disable (toggle availability)",
+    }),
+    provider_id: Type.Optional(Type.String({
+        description: "The provider identifier (required for all actions except list) " +
+            "-- any user-chosen name (e.g., 'nvidia', 'deepseek', 'ollama-local', " +
+            "'groq', 'my-vllm', 'company-internal')",
+    })),
+    config: Type.Optional(Type.Union([
+        Type.Object({
+            type: Type.Optional(Type.String({
+                description: "Provider SDK type -- determines the API protocol. Common values: " +
+                    "openai (any OpenAI-compatible endpoint), anthropic, google, ollama, " +
+                    "groq, mistral, together, deepseek, cerebras, xai, openrouter. " +
+                    "Use 'openai' for custom/self-hosted endpoints that speak the OpenAI " +
+                    "API format (NVIDIA NIM, vLLM, LM Studio, llama.cpp, Fireworks, " +
+                    "Perplexity, etc.)",
+            })),
+            name: Type.Optional(Type.String({ description: "Human-readable display name" })),
+            baseUrl: Type.Optional(Type.String({
+                description: "API base URL (e.g., https://integrate.api.nvidia.com/v1)",
+            })),
+            apiKeyName: Type.Optional(Type.String({
+                description: "SecretManager key name for the API key (NOT the key itself). " +
+                    "Store the key first via gateway env_set. Required for cloud " +
+                    "providers; may be omitted for type='ollama' once keyless " +
+                    "registration lands (until then, all entries with models[] " +
+                    "need a resolvable apiKeyName).",
+            })),
+            enabled: Type.Optional(Type.Boolean({
+                description: "Whether provider is active (default: true)",
+            })),
+            timeoutMs: Type.Optional(Type.Integer({
+                description: "Request timeout in ms (default: 120000)",
+            })),
+            maxRetries: Type.Optional(Type.Integer({
+                description: "Max retries for transient errors (default: 2)",
+            })),
+            headers: Type.Optional(Type.Record(Type.String(), Type.String(), {
+                description: "Custom headers for API requests",
+            })),
+            models: Type.Optional(Type.Array(Type.Object({
+                id: Type.String({
+                    description: "Model ID at provider (e.g., moonshotai/kimi-k2.5)",
+                }),
+                name: Type.Optional(Type.String({ description: "Display name" })),
+                reasoning: Type.Optional(Type.Boolean({
+                    description: "Supports extended thinking",
+                })),
+                contextWindow: Type.Optional(Type.Integer({
+                    description: "Max context tokens",
+                })),
+                maxTokens: Type.Optional(Type.Integer({
+                    description: "Max output tokens",
+                })),
+                input: Type.Optional(Type.Array(Type.Union([Type.Literal("text"), Type.Literal("image")]))),
+            }), { description: "User-defined model entries for this provider" })),
+        }, { description: "Provider configuration for create/update" }),
+        Type.String({
+            description: "Provider config as JSON string (fallback). Prefer object form.",
+        }),
+    ])),
+});
+const VALID_ACTIONS = ["list", "get", "create", "update", "delete", "enable", "disable"];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Coerce config from JSON string to object if LLM double-encoded it. */
+function coerceConfig(p) {
+    const raw = p.config;
+    if (typeof raw === "string") {
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch { /* not valid JSON, fall through */ }
+    }
+    return raw;
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a provider management tool with 7 actions.
+ *
+ * Actions:
+ * - **list** -- List all configured providers
+ * - **get** -- Get provider configuration and status
+ * - **create** -- Register a new provider (requires approval)
+ * - **update** -- Modify provider configuration
+ * - **delete** -- Remove a provider (requires approval)
+ * - **enable** -- Enable a disabled provider
+ * - **disable** -- Disable a provider
+ *
+ * @param rpcCall - RPC call function for delegating to the daemon backend
+ * @param approvalGate - Optional approval gate for create/delete actions
+ * @param callbacks - Optional mutation lifecycle callbacks (onMutationStart/onMutationEnd)
+ * @returns AgentTool implementing the provider management interface
+ */
+export function createProvidersManageTool(rpcCall, approvalGate, callbacks) {
+    return createAdminManageTool({
+        name: "providers_manage",
+        label: "Provider Management",
+        description: "Manage LLM providers: list, get, create, update, delete, enable, disable. " +
+            "Create/delete require approval. API keys must be stored separately via gateway env_set.",
+        parameters: ProvidersManageToolParams,
+        validActions: VALID_ACTIONS,
+        rpcPrefix: "providers",
+        gatedActions: ["create", "delete"],
+        actionOverrides: {
+            async list(_p, rpcCall, ctx) {
+                return rpcCall("providers.list", { _trustLevel: ctx.trustLevel });
+            },
+            async get(p, rpcCall, ctx) {
+                const providerId = readStringParam(p, "provider_id");
+                return rpcCall("providers.get", { providerId, _trustLevel: ctx.trustLevel });
+            },
+            async create(p, rpcCall, ctx) {
+                const providerId = readStringParam(p, "provider_id");
+                const config = coerceConfig(p);
+                callbacks?.onMutationStart?.();
+                try {
+                    return await rpcCall("providers.create", { providerId, config, _trustLevel: ctx.trustLevel });
+                }
+                finally {
+                    callbacks?.onMutationEnd?.();
+                }
+            },
+            async update(p, rpcCall, ctx) {
+                const providerId = readStringParam(p, "provider_id");
+                const config = coerceConfig(p);
+                callbacks?.onMutationStart?.();
+                try {
+                    return await rpcCall("providers.update", { providerId, config, _trustLevel: ctx.trustLevel });
+                }
+                finally {
+                    callbacks?.onMutationEnd?.();
+                }
+            },
+            async delete(p, rpcCall, ctx) {
+                const providerId = readStringParam(p, "provider_id");
+                callbacks?.onMutationStart?.();
+                try {
+                    return await rpcCall("providers.delete", { providerId, _trustLevel: ctx.trustLevel });
+                }
+                finally {
+                    callbacks?.onMutationEnd?.();
+                }
+            },
+            async enable(p, rpcCall, ctx) {
+                const providerId = readStringParam(p, "provider_id");
+                callbacks?.onMutationStart?.();
+                try {
+                    return await rpcCall("providers.enable", { providerId, _trustLevel: ctx.trustLevel });
+                }
+                finally {
+                    callbacks?.onMutationEnd?.();
+                }
+            },
+            async disable(p, rpcCall, ctx) {
+                const providerId = readStringParam(p, "provider_id");
+                callbacks?.onMutationStart?.();
+                try {
+                    return await rpcCall("providers.disable", { providerId, _trustLevel: ctx.trustLevel });
+                }
+                finally {
+                    callbacks?.onMutationEnd?.();
+                }
+            },
+        },
+    }, rpcCall, approvalGate, callbacks);
+}

package/node_modules/@comis/skills/dist/index.d.ts

@@ -33,7 +33,7 @@ export { expandSkillForInvocation } from "./prompt/processor.js";
 export { scanSkillContent, type ContentScanResult, type ContentScanFinding } from "./prompt/content-scanner.js";
 export { createSTTProvider, createFallbackTranscription } from "./integrations/stt-factory.js";
 export { preprocessMessage } from "./integrations/media-preprocessor.js";
-export { createMemorySearchTool, createMemoryGetTool, createMemoryStoreTool, createSessionStatusTool, createSessionsListTool, createSessionsHistoryTool, createSessionsSendTool, createSessionsSpawnTool, createSessionSearchTool, createAgentsListTool, createSubagentsTool, createPipelineTool, createMessageTool, createCronTool, type RpcCall, createDiscordActionTool, createTelegramActionTool, createSlackActionTool, createWhatsAppActionTool, createImageTool, createTTSTool, createTranscribeAudioTool, createDescribeVideoTool, createExtractDocumentTool, createGatewayTool, createBrowserTool, createHeartbeatManageTool, createNotifyTool, createImageGenerateTool, createCtxSearchTool, createCtxInspectTool, createCtxRecallTool, createCtxExpandTool, createAgentsManageTool, createObsQueryTool, createMemoryManageTool, createSessionsManageTool, createModelsManageTool, createTokensManageTool, createChannelsManageTool, createSkillsManageTool, createMcpManageTool, createBackgroundTasksTool, createUnifiedSessionTool, createUnifiedMemoryTool, createUnifiedContextTool, } from "./builtin/platform/index.js";
+export { createMemorySearchTool, createMemoryGetTool, createMemoryStoreTool, createSessionStatusTool, createSessionsListTool, createSessionsHistoryTool, createSessionsSendTool, createSessionsSpawnTool, createSessionSearchTool, createSubagentsTool, createPipelineTool, createMessageTool, createCronTool, type RpcCall, createDiscordActionTool, createTelegramActionTool, createSlackActionTool, createWhatsAppActionTool, createImageTool, createTTSTool, createTranscribeAudioTool, createDescribeVideoTool, createExtractDocumentTool, createGatewayTool, createBrowserTool, createHeartbeatManageTool, createNotifyTool, createImageGenerateTool, createCtxSearchTool, createCtxInspectTool, createCtxRecallTool, createCtxExpandTool, createAgentsManageTool, createObsQueryTool, createMemoryManageTool, createSessionsManageTool, createModelsManageTool, createProvidersManageTool, createTokensManageTool, createChannelsManageTool, createSkillsManageTool, createMcpManageTool, createBackgroundTasksTool, createUnifiedSessionTool, createUnifiedMemoryTool, createUnifiedContextTool, } from "./builtin/platform/index.js";
 export { createBrowserService } from "./browser/index.js";
 export type { BrowserService, ActParams } from "./browser/index.js";
 export { createTTSProvider } from "./integrations/tts-factory.js";

package/node_modules/@comis/skills/dist/index.js

@@ -51,7 +51,7 @@ createMemorySearchTool, createMemoryGetTool, createMemoryStoreTool,
 // Session tools
 createSessionStatusTool, createSessionsListTool, createSessionsHistoryTool, createSessionsSendTool, createSessionsSpawnTool, createSessionSearchTool, 
 // Agent tools
-createAgentsListTool, createSubagentsTool, createPipelineTool, 
+createSubagentsTool, createPipelineTool, 
 // Messaging
 createMessageTool, 
 // Scheduling
@@ -71,7 +71,7 @@ createImageGenerateTool,
 // Context DAG tools
 createCtxSearchTool, createCtxInspectTool, createCtxRecallTool, createCtxExpandTool, 
 // Fleet management
-createAgentsManageTool, createObsQueryTool, createMemoryManageTool, createSessionsManageTool, createModelsManageTool, createTokensManageTool, createChannelsManageTool, createSkillsManageTool, createMcpManageTool, 
+createAgentsManageTool, createObsQueryTool, createMemoryManageTool, createSessionsManageTool, createModelsManageTool, createProvidersManageTool, createTokensManageTool, createChannelsManageTool, createSkillsManageTool, createMcpManageTool, 
 // Background tasks
 createBackgroundTasksTool, 
 // Unified tools (action dispatch -- consolidates individual tools)

package/node_modules/@comis/skills/dist/policy/tool-policy.js

@@ -97,7 +97,6 @@ export const TOOL_GROUPS = {
         "session_status",
         "session_search",
         "subagents",
-        "agents_list",
         "pipeline",
     ],
     "group:platform_actions": [

package/node_modules/@comis/skills/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@comis/skills",
   "private": true,
-  "version": "1.0.24",
+  "version": "1.0.26",
   "author": "Moshe Anconina",
   "license": "Apache-2.0",
   "description": "Skill system, MCP integration, and tool sandbox for Comis agents",