@townco/agent 0.1.87 → 0.1.98

package/dist/acp-server/adapter.d.ts

@@ -11,6 +11,18 @@ export declare const SUBAGENT_MODE_KEY = "town.com/isSubagent";
 export interface SubagentModeExtension {
     [SUBAGENT_MODE_KEY]?: boolean;
 }
+/**
+ * Citation source extracted from tool outputs (WebSearch, WebFetch, MCP tools)
+ */
+export interface CitationSource {
+    id: string;
+    url: string;
+    title: string;
+    snippet?: string;
+    favicon?: string;
+    toolCallId: string;
+    sourceName?: string;
+}
 /** Adapts an Agent to speak the ACP protocol */
 export declare class AgentAcpAdapter implements acp.Agent {
     private connection;
@@ -32,6 +44,8 @@ export declare class AgentAcpAdapter implements acp.Agent {
     /**
      * Extract tool metadata from the agent definition for exposing to clients.
      * This provides basic info about available tools without loading them fully.
+     * For tool groups (like town_e2b, filesystem), dynamically extracts children
+     * tools info from the actual tool factories.
      */
     private getToolsMetadata;
     /**
@@ -43,6 +57,30 @@ export declare class AgentAcpAdapter implements acp.Agent {
      * This provides info about subagents configured via makeSubagentsTool.
      */
     private getSubagentsMetadata;
+    /**
+     * Extract citation sources from tool output.
+     * Supports WebSearch (Exa results), WebFetch, library/document retrieval tools,
+     * and generic URL extraction from MCP tools.
+     */
+    private extractSourcesFromToolOutput;
+    /**
+     * Extract citation sources from a subagent result.
+     * The sources are already re-numbered by the runner with unique IDs (1001+, 2001+, etc.)
+     * to avoid conflicts with parent agent sources.
+     */
+    private extractSubagentSources;
+    /**
+     * Helper to derive favicon URL from a domain
+     */
+    private getFaviconUrl;
+    /**
+     * Helper to extract domain name from URL
+     */
+    private getSourceName;
+    /**
+     * Helper to extract URLs from text content
+     */
+    private extractUrlsFromText;
     private saveSessionToDisk;
     initialize(_params: acp.InitializeRequest): Promise<acp.InitializeResponse>;
     newSession(params: acp.NewSessionRequest): Promise<acp.NewSessionResponse>;
@@ -59,4 +97,15 @@ export declare class AgentAcpAdapter implements acp.Agent {
     private executeHooksIfConfigured;
     private _executeHooksImpl;
     cancel(params: acp.CancelNotification): Promise<void>;
+    /**
+     * Edit and resend a message from a specific point in the conversation.
+     * This truncates the session history to the specified user message
+     * and then prompts with the new content.
+     *
+     * @param sessionId - The session to edit
+     * @param userMessageIndex - The index of which user message to edit (0-based, counting only user messages)
+     * @param newPrompt - The new prompt content to send
+     * @returns PromptResponse from the agent
+     */
+    editAndResend(sessionId: string, userMessageIndex: number, newPrompt: acp.PromptRequest["prompt"]): Promise<acp.PromptResponse>;
 }