@dudousxd/nestjs-agent-opencode 0.2.1 → 0.3.0

package/dist/{engine-0YkBLWZR.d.cts → engine-Cp5uysaN.d.cts}

@@ -1,6 +1,6 @@
 import { AgentDepsFactory, ChatQueueService, AgentEngine } from '@dudousxd/nestjs-agent';
 import { ConflictException, Logger, OnApplicationShutdown, Type, InjectionToken, Provider } from '@nestjs/common';
-import { ElicitationRequest, CostSource, AgentRunInput, SinkWriter, AgentStore, ApprovalRequirement, MessageUsage, AgentUiComponent, HumanReply, Actor, StoredMessage, ToolRegistry, TokenStreamSink, SkillsConfig, MemoryConfig, AgentPricingStore, PriceCatalogOptions, RolesPolicy, RememberToolInput, AiToolCtx } from '@dudousxd/nestjs-agent-core';
+import { ElicitationRequest, CostSource, AgentRunInput, SinkWriter, AgentStore, ApprovalRequirement, ToolPresentation, MessageUsage, AgentUiComponent, HumanReply, Actor, StoredMessage, ToolRegistry, TokenStreamSink, SkillsConfig, MemoryConfig, AgentPricingStore, PriceCatalogOptions, RolesPolicy, RememberToolInput, AiToolCtx } from '@dudousxd/nestjs-agent-core';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 
@@ -297,6 +297,15 @@ interface OpenCodeTurnArgs {
     store: AgentStore;
     /** What an action needs before it runs (the module's `ApprovalPolicy`). */
     approvalFor: (action: string) => Promise<ApprovalRequirement>;
+    /**
+     * The app tool a permission `action` names, with its presentation: its `confirm` templates (filled
+     * from the call's arguments) word the approval card. `undefined` (or omitted) → an OpenCode
+     * built-in, worded from its name.
+     */
+    approvalPresentation?: (action: string) => {
+        name: string;
+        presentation?: ToolPresentation;
+    } | undefined;
     /** The model label usage is recorded under until OpenCode names the step's model. */
     modelLabel: string;
     /**
@@ -819,6 +828,11 @@ declare class OpenCodeTurns implements OnApplicationShutdown {
     }): Promise<StepCost>;
     /** The tools server's name in OpenCode. */
     get toolsServer(): string;
+    /** The app tool an OpenCode permission `action` names, and its presentation — `undefined` for a built-in. */
+    presentationOf(action: string): {
+        name: string;
+        presentation?: ToolPresentation;
+    } | undefined;
     /** The roles policy a turn's tools are gated by (the agent's own). */
     rolesPolicyFor(input: Pick<AgentRunInput, 'agentName'>): RolesPolicy;
     /** The tools a turn may reach: the agent's allow-list, narrowed by its persona's. */

package/dist/{engine-0YkBLWZR.d.ts → engine-Cp5uysaN.d.ts}

@@ -1,6 +1,6 @@
 import { AgentDepsFactory, ChatQueueService, AgentEngine } from '@dudousxd/nestjs-agent';
 import { ConflictException, Logger, OnApplicationShutdown, Type, InjectionToken, Provider } from '@nestjs/common';
-import { ElicitationRequest, CostSource, AgentRunInput, SinkWriter, AgentStore, ApprovalRequirement, MessageUsage, AgentUiComponent, HumanReply, Actor, StoredMessage, ToolRegistry, TokenStreamSink, SkillsConfig, MemoryConfig, AgentPricingStore, PriceCatalogOptions, RolesPolicy, RememberToolInput, AiToolCtx } from '@dudousxd/nestjs-agent-core';
+import { ElicitationRequest, CostSource, AgentRunInput, SinkWriter, AgentStore, ApprovalRequirement, ToolPresentation, MessageUsage, AgentUiComponent, HumanReply, Actor, StoredMessage, ToolRegistry, TokenStreamSink, SkillsConfig, MemoryConfig, AgentPricingStore, PriceCatalogOptions, RolesPolicy, RememberToolInput, AiToolCtx } from '@dudousxd/nestjs-agent-core';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 
@@ -297,6 +297,15 @@ interface OpenCodeTurnArgs {
     store: AgentStore;
     /** What an action needs before it runs (the module's `ApprovalPolicy`). */
     approvalFor: (action: string) => Promise<ApprovalRequirement>;
+    /**
+     * The app tool a permission `action` names, with its presentation: its `confirm` templates (filled
+     * from the call's arguments) word the approval card. `undefined` (or omitted) → an OpenCode
+     * built-in, worded from its name.
+     */
+    approvalPresentation?: (action: string) => {
+        name: string;
+        presentation?: ToolPresentation;
+    } | undefined;
     /** The model label usage is recorded under until OpenCode names the step's model. */
     modelLabel: string;
     /**
@@ -819,6 +828,11 @@ declare class OpenCodeTurns implements OnApplicationShutdown {
     }): Promise<StepCost>;
     /** The tools server's name in OpenCode. */
     get toolsServer(): string;
+    /** The app tool an OpenCode permission `action` names, and its presentation — `undefined` for a built-in. */
+    presentationOf(action: string): {
+        name: string;
+        presentation?: ToolPresentation;
+    } | undefined;
     /** The roles policy a turn's tools are gated by (the agent's own). */
     rolesPolicyFor(input: Pick<AgentRunInput, 'agentName'>): RolesPolicy;
     /** The tools a turn may reach: the agent's allow-list, narrowed by its persona's. */

package/dist/index.cjs

@@ -1071,6 +1071,8 @@ ${delta}` : delta;
     }
     const ttlMs = requirement.ttlMs !== void 0 && Number.isFinite(requirement.ttlMs) && requirement.ttlMs > 0 ? Math.floor(requirement.ttlMs) : void 0;
     const expiresAt = ttlMs !== void 0 ? new Date(Date.now() + ttlMs).toISOString() : void 0;
+    const tool = this.a.approvalPresentation?.(action);
+    const confirmation = tool !== void 0 ? (0, import_nestjs_agent_core2.resolveToolConfirmation)(tool.name, args, tool.presentation) : void 0;
     this.segment.calls.push({
       id: req.id,
       name: action,
@@ -1085,6 +1087,9 @@ ${delta}` : delta;
       toolType: "action",
       input: args,
       status: "pending_approval",
+      ...confirmation !== void 0 ? {
+        confirmation
+      } : {},
       runId: this.a.runId,
       approver: requirement.approver,
       ...expiresAt !== void 0 ? {
@@ -1102,6 +1107,9 @@ ${delta}` : delta;
       kind: "approval-requested",
       id: req.id,
       approver: requirement.approver,
+      ...confirmation !== void 0 ? {
+        confirmation
+      } : {},
       ...expiresAt !== void 0 ? {
         expiresAt
       } : {}
@@ -1882,6 +1890,25 @@ var OpenCodeTurns = class {
   get toolsServer() {
     return this.settings.tools?.server ?? "aviary";
   }
+  /** The app tool an OpenCode permission `action` names, and its presentation — `undefined` for a built-in. */
+  presentationOf(action) {
+    if (this.settings.tools === void 0) return void 0;
+    const server = this.toolsServer;
+    for (const prefix of [
+      `${server}.`,
+      `${server}_`
+    ]) {
+      if (!action.startsWith(prefix)) continue;
+      const spec = this.registry.spec(action.slice(prefix.length));
+      if (spec !== void 0) return {
+        name: spec.name,
+        ...spec.presentation !== void 0 ? {
+          presentation: spec.presentation
+        } : {}
+      };
+    }
+    return void 0;
+  }
   /** The roles policy a turn's tools are gated by (the agent's own). */
   rolesPolicyFor(input) {
     return this.deps.forAgent(input.agentName).rolesPolicy;
@@ -2614,6 +2641,9 @@ ${body}
           agentName: input.agentName
         } : {}
       }), "approvalFor"),
+      // An app tool reaches OpenCode as `<server>.<name>` / `<server>_<name>`: its own presentation
+      // words the approval card. OpenCode's built-ins (`bash`, `edit`) have none.
+      approvalPresentation: /* @__PURE__ */ __name((action) => this.presentationOf(action), "approvalPresentation"),
       modelLabel: input.model ?? "opencode",
       priceStep: /* @__PURE__ */ __name((step) => this.priceStep(step), "priceStep"),
       ...spent !== void 0 ? {