@sepveneto/dnde-agent 0.2.0-beta.4 → 0.2.0-beta.6

package/dist/index.d.ts

@@ -9,12 +9,14 @@ export type { CreateAgentsOptions } from './agents';
 export { createAgents, DEFAULT_AGENT_BFF_URL, DEFAULT_AGENT_MODEL, } from './agents';
 export type { PreparedEditorOperation, } from './editorContext';
 export { completeEditorOperation, createEditorAgentContext, editorOperationSucceeded, prepareEditorOperation, } from './editorContext';
+export type { AgentInitializationMode, AgentInitializationRequest, AgentInitializationResult, AgentInitializationTool, } from './initialization';
+export { defineInitializationTool, findInitializationTool, INITIALIZATION_TOOL_ROLE, } from './initialization';
 export type { AgentRuntime, AgentRuntimeConfig, AgentRuntimeOptions, AgentRuntimeTurn, } from './runtime';
 export { createAgentRuntime } from './runtime';
 export type { AgentUploadedFile } from './services';
 export { resolveAgentServiceURL } from './services';
 export type { AgentToolApprovalOptions, AgentToolContext, AgentToolDefinition, } from './tool';
 export { defineAgentTool, defineCapability, } from './tool';
-export type { AgentApiMode, AgentEditorApi, AgentEditorOperation, AgentHostApi, AgentModelConfig, ChatMessage, ChatMode, DataPart, EditorAgentContext, FilePart, MessagePart, MessageRole, ReasoningPart, TextPart, ToolPart, } from './types';
+export type { AgentApiMode, AgentEditorApi, AgentEditorOperation, AgentFileKind, AgentHostApi, AgentModelConfig, ChatMessage, ChatMode, DataPart, EditorAgentContext, FilePart, MessagePart, MessageRole, ReasoningPart, TextPart, ToolPart, } from './types';
 export { Agent, MemorySession, run, Runner, tool, } from '@openai/agents';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,KAAK,CAAA;AAIhD,eAAO,MAAM,QAAQ,sFAAU,CAAA;AAE/B;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,qBAAqB,CAE1D;AAED,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAEnD,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAE9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAEnD,YAAY,EACV,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,QAAQ,CAAA;AAEf,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,QAAQ,CAAA;AACf,YAAY,EACV,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,WAAW,EACX,aAAa,EACb,QAAQ,EACR,QAAQ,GACT,MAAM,SAAS,CAAA;AAEhB,OAAO,EACL,KAAK,EACL,aAAa,EACb,GAAG,EACH,MAAM,EACN,IAAI,GACL,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,KAAK,CAAA;AAIhD,eAAO,MAAM,QAAQ,sFAAU,CAAA;AAE/B;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,qBAAqB,CAE1D;AAED,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAEnD,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAE9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAEnD,YAAY,EACV,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,QAAQ,CAAA;AAEf,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,QAAQ,CAAA;AACf,YAAY,EACV,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,WAAW,EACX,aAAa,EACb,QAAQ,EACR,QAAQ,GACT,MAAM,SAAS,CAAA;AAEhB,OAAO,EACL,KAAK,EACL,aAAa,EACb,GAAG,EACH,MAAM,EACN,IAAI,GACL,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -1,21 +1,24 @@
-import { c as t, D as s, k as n, B as r, g as o, R as i, l as A, h as E, v as c, j as d, m as g, y as p, z as l, q as m, u, x as L, E as R, t as T } from "./index-BozWbCey.js";
+import { c as t, D as n, k as s, I as i, F as o, g as r, R as A, l as d, h as l, y as E, j as T, m as c, B as g, E as p, v as I, q as L, x as O, u as _, z as m, G as R, t as f } from "./index-UcU5ZdM-.js";
 export {
   t as Agent,
-  s as DEFAULT_AGENT_BFF_URL,
-  n as DEFAULT_AGENT_MODEL,
-  r as MemorySession,
-  o as MpdAgent,
-  i as Runner,
-  A as completeEditorOperation,
-  E as createAgentElement,
-  c as createAgentRuntime,
-  d as createAgents,
-  g as createEditorAgentContext,
-  p as defineAgentTool,
-  l as defineCapability,
-  m as editorOperationSucceeded,
-  u as prepareEditorOperation,
-  L as resolveAgentServiceURL,
+  n as DEFAULT_AGENT_BFF_URL,
+  s as DEFAULT_AGENT_MODEL,
+  i as INITIALIZATION_TOOL_ROLE,
+  o as MemorySession,
+  r as MpdAgent,
+  A as Runner,
+  d as completeEditorOperation,
+  l as createAgentElement,
+  E as createAgentRuntime,
+  T as createAgents,
+  c as createEditorAgentContext,
+  g as defineAgentTool,
+  p as defineCapability,
+  I as defineInitializationTool,
+  L as editorOperationSucceeded,
+  O as findInitializationTool,
+  _ as prepareEditorOperation,
+  m as resolveAgentServiceURL,
   R as run,
-  T as tool
+  f as tool
 };

package/dist/initialization.d.ts

@@ -0,0 +1,50 @@
+import type { AgentToolDefinition } from './tool';
+export declare const INITIALIZATION_TOOL_ROLE: "initialization";
+/** Lightweight context a host can show while asking how to initialize a page. */
+export interface AgentInitializationRequest {
+    /**
+     * A short summary of the user's checklist or page request. The full document
+     * remains in the conversation and is intentionally not duplicated here.
+     */
+    checklistSummary?: string;
+}
+export type AgentInitializationMode = 'custom' | 'reference' | 'cancelled';
+/**
+ * Host-owned result of the initialization choice.
+ *
+ * `custom` lets the model design from the user's checklist. `reference` uses a
+ * reference ID explicitly entered by the user. `cancelled` stops initialization
+ * and waits for the user.
+ */
+export interface AgentInitializationResult {
+    mode: AgentInitializationMode;
+    /** Required when mode is `reference`; entered by the user. */
+    referenceId?: string;
+    /** Reference data fetched by the host using `referenceId`. */
+    referenceData?: unknown;
+}
+/**
+ * Optional host tool invoked whenever the agent enters initialization mode.
+ * The host owns the interaction and result shape; the agent only consumes the
+ * returned value as context for the initialization.
+ */
+export type AgentInitializationTool = AgentToolDefinition<AgentInitializationRequest, unknown> & {
+    role: typeof INITIALIZATION_TOOL_ROLE;
+};
+/**
+ * Define the optional host-owned initialization tool.
+ */
+export declare function defineInitializationTool(definition: Omit<AgentInitializationTool, 'kind' | 'role'>): AgentInitializationTool;
+/** Find the optional host-owned initialization tool. */
+export declare function findInitializationTool(tools?: readonly AgentToolDefinition[]): AgentToolDefinition | undefined;
+export declare const INITIALIZATION_AGENT_NAME = "Initialization Agent";
+export declare const INITIALIZATION_HANDOFF_TOOL_NAME = "start_initialization";
+export declare const INITIALIZATION_RETURN_TOOL_NAME = "finish_initialization";
+/** Main-agent instructions for deciding when to hand off to the initializer. */
+export declare function buildInitializationInstructions(options?: {
+    toolName?: string;
+    agentName?: string;
+}): string[];
+/** Instructions for the isolated initialization sub-agent. */
+export declare function buildInitializationAgentInstructions(toolName: string, mainAgentName: string): string[];
+//# sourceMappingURL=initialization.d.ts.map

package/dist/initialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialization.d.ts","sourceRoot":"","sources":["../src/initialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AAEjD,eAAO,MAAM,wBAAwB,EAAG,gBAAyB,CAAA;AAEjE,iFAAiF;AACjF,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAA;AAE1E;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,uBAAuB,CAAA;IAC7B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,CACvD,0BAA0B,EAC1B,OAAO,CACR,GAAG;IACF,IAAI,EAAE,OAAO,wBAAwB,CAAA;CACtC,CAAA;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM,CAAC,GACzD,uBAAuB,CAMzB;AAED,wDAAwD;AACxD,wBAAgB,sBAAsB,CACpC,KAAK,GAAE,SAAS,mBAAmB,EAAO,GACzC,mBAAmB,GAAG,SAAS,CAEjC;AAED,eAAO,MAAM,yBAAyB,yBAAyB,CAAA;AAC/D,eAAO,MAAM,gCAAgC,yBAAyB,CAAA;AACtE,eAAO,MAAM,+BAA+B,0BAA0B,CAAA;AAEtE,gFAAgF;AAChF,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACd,GACL,MAAM,EAAE,CAwBV;AAED,8DAA8D;AAC9D,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,MAAM,EAAE,CASV"}

package/dist/runtime.d.ts

@@ -1,5 +1,5 @@
 import type { AgentToolDefinition } from './tool';
-import type { AgentHostApi, ChatMessage, ChatMode } from './types';
+import type { AgentHostApi, ChatMessage, ChatMode, FilePart } from './types';
 export interface AgentRuntimeConfig {
     baseURL: string;
     model: string;
@@ -16,6 +16,7 @@ export interface AgentRuntimeTurn {
     mode: ChatMode;
     message: ChatMessage;
     history: ChatMessage[];
+    attachments?: FilePart[];
     signal: AbortSignal;
     onUpdate: () => void;
 }

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAyB,MAAM,SAAS,CAAA;AAkBzF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,WAAW,GAAG,kBAAkB,CAAA;CAC1C;AAED,MAAM,WAAW,mBAAoB,SAAQ,OAAO,CAAC,kBAAkB,CAAC;IACtE,GAAG,CAAC,EAAE,YAAY,CAAA;IAClB,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,WAAW,CAAA;IACpB,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,MAAM,EAAE,WAAW,CAAA;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAA;IAC7C,OAAO,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACnD;AAgMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,mBAAwB,GAChC,YAAY,CA+Jd"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,QAAQ,EAGT,MAAM,SAAS,CAAA;AAuBhB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,WAAW,GAAG,kBAAkB,CAAA;CAC1C;AAED,MAAM,WAAW,mBAAoB,SAAQ,OAAO,CAAC,kBAAkB,CAAC;IACtE,GAAG,CAAC,EAAE,YAAY,CAAA;IAClB,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,WAAW,CAAA;IACpB,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAA;IACxB,MAAM,EAAE,WAAW,CAAA;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAA;IAC7C,OAAO,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACnD;AA+KD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,mBAAwB,GAChC,YAAY,CAyOd"}

package/dist/services.d.ts

@@ -1,18 +1,44 @@
-import type { FilePart } from './types';
+import type { AgentFileKind, FilePart } from './types';
+export declare const AGENT_DOCUMENT_MAX_SIZE: number;
+export declare const AGENT_IMAGE_MAX_SIZE: number;
+/** @deprecated Use the format-specific upload limits. */
 export declare const AGENT_UPLOAD_MAX_SIZE: number;
 export interface AgentUploadedFile {
     /** Server-side upload id. */
     name: string;
     /** Original file name. */
     file: string;
+    kind: AgentFileKind;
+    mimeType: string;
+    /** BFF URL used for thumbnails and previews. */
+    url: string;
     size?: number;
 }
+export declare function getAgentFileKind(file: Pick<File, 'name' | 'type'>): AgentFileKind | undefined;
+export declare function isAgentImageFilePart(part: FilePart): boolean;
 /**
  * Model APIs normally live under `/v1`, while upload and document conversion
  * endpoints live at the BFF root. Keep any deployment prefix in the base URL.
  */
 export declare function resolveAgentServiceURL(baseURL: string, path: string): string;
-export declare function uploadAgentDocument(baseURL: string, file: File): Promise<AgentUploadedFile>;
+export declare function uploadAgentFile(baseURL: string, file: File): Promise<AgentUploadedFile>;
+/** @deprecated Use uploadAgentFile. */
+export declare const uploadAgentDocument: typeof uploadAgentFile;
 export declare function readAgentDocumentMarkdown(baseURL: string, uploaded: AgentUploadedFile): Promise<string>;
+export declare function readAgentImageData(baseURL: string, uploaded: Pick<AgentUploadedFile, 'name'>): Promise<string>;
+export type AgentUserContent = {
+    type: 'input_image';
+    image: string;
+    detail: 'high';
+} | {
+    type: 'input_text';
+    text: string;
+};
+/**
+ * Qwen's OpenAI-compatible API expects images and text in one user message.
+ * Put images first so visual context is available when the model reads the
+ * accompanying layout instructions.
+ */
+export declare function buildAgentUserContent(prompt: string, imageDataUrls: readonly string[]): string | AgentUserContent[];
 export declare function formatAgentDocumentContext(file: FilePart): string;
 //# sourceMappingURL=services.d.ts.map

package/dist/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,eAAO,MAAM,qBAAqB,QAAmB,CAAA;AAErD,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AASD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5E;AAsBD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CASjE"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEtD,eAAO,MAAM,uBAAuB,QAAmB,CAAA;AACvD,eAAO,MAAM,oBAAoB,QAAmB,CAAA;AACpD,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,QAA0B,CAAA;AAE5D,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,aAAa,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AA8BD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,GAChC,aAAa,GAAG,SAAS,CAY3B;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,GACb,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5E;AAsBD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,iBAAiB,CAAC,CAuB5B;AAED,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,wBAAkB,CAAA;AAElD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1C;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,MAAM,GAAG,gBAAgB,EAAE,CAc7B;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CASjE"}

package/dist/tool.d.ts

@@ -1,5 +1,7 @@
 import type { z } from 'zod';
 import type { AgentHostApi, EditorAgentContext } from './types';
+/** Workflow roles understood by the built-in agent topology. */
+export type AgentToolRole = 'initialization';
 export interface AgentToolContext {
     api: AgentHostApi;
     getContext: () => Record<string, unknown>;
@@ -15,6 +17,8 @@ export interface AgentToolDefinition<TInput = unknown, TOutput = unknown> {
     kind?: 'agent-tool';
     name: string;
     description: string;
+    /** Optional workflow role used by the agent topology. */
+    role?: AgentToolRole;
     parameters?: z.ZodType;
     /** Alias kept for existing capability definitions. */
     inputSchema?: z.ZodType;

package/dist/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,YAAY,CAAA;IACjB,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,0DAA0D;IAC1D,OAAO,EAAE,kBAAkB,CAAA;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAA;CACjC;AAED,MAAM,WAAW,mBAAmB,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACtE,iFAAiF;IACjF,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAA;IACtB,sDAAsD;IACtD,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;IACzE,QAAQ,CAAC,EAAE,wBAAwB,CAAA;IACnC,OAAO,EAAE,CACP,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,KACtB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAChC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACjE,UAAU,EAAE,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/C,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtC;AAED,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,wBAAkB,CAAA"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAE/D,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAA;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,YAAY,CAAA;IACjB,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,0DAA0D;IAC1D,OAAO,EAAE,kBAAkB,CAAA;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAA;CACjC;AAED,MAAM,WAAW,mBAAmB,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACtE,iFAAiF;IACjF,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAA;IACtB,sDAAsD;IACtD,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;IACzE,QAAQ,CAAC,EAAE,wBAAwB,CAAA;IACnC,OAAO,EAAE,CACP,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,KACtB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAChC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACjE,UAAU,EAAE,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/C,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtC;AAED,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,wBAAkB,CAAA"}

package/dist/types.d.ts

@@ -1,6 +1,7 @@
 export type ChatMode = 'data' | 'text';
 export type MessageRole = 'system' | 'user' | 'assistant';
 export type AgentApiMode = 'responses' | 'chat_completions';
+export type AgentFileKind = 'document' | 'image';
 export interface AgentModelConfig {
     /** OpenAI-compatible endpoint exposed by the host or its BFF. */
     baseURL?: string;
@@ -9,7 +10,7 @@ export interface AgentModelConfig {
 }
 export interface AgentEditorOperation {
     action: 'add' | 'edit' | 'delete' | 'move';
-    /** Existing node UUID. For `add`, this is the optional parent UUID. */
+    /** Existing node UUID used by edit, delete, and move operations. */
     target?: string;
     /** Widget type id used by `add`. */
     widget?: string;
@@ -40,7 +41,8 @@ export interface EditorAgentContext extends Record<string, unknown> {
 export interface AgentEditorApi {
     getCurrentEditor: () => unknown | Promise<unknown>;
     getWidgets: () => unknown | Promise<unknown>;
-    operateEditor: (operation: AgentEditorOperation) => unknown | Promise<unknown>;
+    /** Context contains business data prepared by tools during the current Agent Run. */
+    operateEditor: (operation: AgentEditorOperation, context?: EditorAgentContext) => unknown | Promise<unknown>;
 }
 export interface AgentHostApi {
     model?: AgentModelConfig;
@@ -70,13 +72,18 @@ export interface DataPart {
 }
 export interface FilePart {
     type: 'file';
-    /** Server-side upload id used to retrieve the converted document. */
+    /** Server-side upload id used to retrieve the file content. */
     name: string;
     /** Original file name shown to the user. */
     file: string;
+    /** Missing on legacy stored document parts. */
+    kind?: AgentFileKind;
+    mimeType?: string;
     size?: number;
     /** Converted document content sent to the agent as context. */
     text?: string;
+    /** BFF URL used to render an image preview without persisting Base64 data. */
+    url?: string;
 }
 export type MessagePart = TextPart | ReasoningPart | ToolPart | DataPart | FilePart;
 export interface ChatMessage {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;AACtC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;AACzD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,kBAAkB,CAAA;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC1C,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,YAAY,EAAE,OAAO,EAAE,CAAA;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAClD,UAAU,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5C,aAAa,EAAE,CAAC,SAAS,EAAE,oBAAoB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC/E;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CAAA;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEnF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sepveneto/dnde-agent",
   "type": "module",
-  "version": "0.2.0-beta.4",
+  "version": "0.2.0-beta.6",
   "description": "",
   "author": "",
   "license": "ISC",