synthos 0.8.0 → 0.10.0

package/dist/service/transformPage.d.ts

@@ -1,22 +1,18 @@
-import { AgentArgs, AgentCompletion } from "../models";
-import { ThemeInfo } from "../themes";
-import { ConnectorsConfig } from "../connectors";
-import { AgentConfig } from "../agents";
-export interface TransformPageArgs extends AgentArgs {
-    pagesFolder: string;
+import { AgentCompletion } from "../models";
+import { Customizer } from "../customizer";
+import { Attachment, Builder, ContextSection } from "../builders/types";
+export interface TransformPageArgs {
     pageState: string;
     message: string;
     instructions?: string;
-    /** Provider-specific formatting instructions injected into the prompt. */
-    modelInstructions?: string;
-    /** Active theme metadata for theme-aware page generation. */
-    themeInfo?: ThemeInfo;
-    /** Page mode. */
-    mode?: 'unlocked' | 'locked';
-    /** User's configured connectors (from settings). */
-    configuredConnectors?: ConnectorsConfig;
-    /** User's configured A2A agents (from settings). */
-    configuredAgents?: AgentConfig[];
+    builder: Builder;
+    additionalSections: ContextSection[];
+    /** True when this is the builder page (has chat panel). */
+    isBuilder?: boolean;
+    /** Product name for branding in prompts (defaults to 'SynthOS'). */
+    productName?: string;
+    /** Optional image attachments sent alongside the user message. */
+    attachments?: Attachment[];
 }
 export type ChangeOp = {
     op: "update";
@@ -38,6 +34,16 @@ export type ChangeOp = {
     op: "style-element";
     nodeId: string;
     style: string;
+} | {
+    op: "search-replace";
+    nodeId: string;
+    search: string;
+    replace: string;
+} | {
+    op: "search-insert";
+    nodeId: string;
+    after: string;
+    content: string;
 };
 export type ChangeList = ChangeOp[];
 export interface TransformPageResult {
@@ -45,6 +51,11 @@ export interface TransformPageResult {
     changeCount: number;
 }
 export declare function transformPage(args: TransformPageArgs): Promise<AgentCompletion<TransformPageResult>>;
+/**
+ * Lightweight markdown-to-HTML converter for chat reply text.
+ * Handles: code blocks, inline code, bold, italic, links, unordered/ordered lists, paragraphs.
+ */
+export declare function simpleMarkdown(text: string): string;
 /**
  * Assign sequential `data-node-id` to every element in the HTML.
  */
@@ -56,6 +67,16 @@ export declare function assignNodeIds(html: string): {
  * Remove all `data-node-id` attributes from the HTML.
  */
 export declare function stripNodeIds(html: string): string;
+/**
+ * Find `needle` in `haystack` using whitespace-normalized comparison.
+ * Collapses runs of whitespace (spaces, tabs, newlines) into a single space
+ * for comparison purposes but returns the position in the original string.
+ * Returns -1 if no match found.
+ */
+export declare function normalizedIndexOf(haystack: string, needle: string): {
+    start: number;
+    end: number;
+} | null;
 /**
  * Remove duplicate inline `<script>` blocks using a two-pass approach.
  *
@@ -80,13 +101,19 @@ export declare function ensureScriptsBeforeBodyClose(html: string): string;
  * Apply a list of CRUD operations to annotated HTML (elements must have `data-node-id`).
  */
 export declare function applyChangeList(html: string, changes: ChangeList): string;
-/**
- * Inject an error script block into the page HTML.
- */
-export declare function injectError(html: string, message: string, details: string): string;
 /**
  * Parse a JSON change list from the model's raw response text.
  * Handles responses that may include markdown fences or extra text around the JSON.
  */
 export declare function parseChangeList(response: string): ChangeList;
+export declare function getMessageFormat(productName: string): string;
+export declare function getTransformInstr(productName: string): string;
+export declare const AGENT_API_REFERENCE = "## Agent API\n\nCheck availability first (required):\n  const agents = await synthos.agents.list({ enabled: true });\n\nSend a message (returns full response):\n  const result = await synthos.agents.send(agentId, message);\n  // result: { kind: 'message', text: 'response text', raw: {...} }\n\nSend with file/image attachments:\n  const result = await synthos.agents.send(agentId, message, [\n    { fileName: 'photo.jpg', mimeType: 'image/jpeg', content: '<base64-string>' }\n  ]);\n\nStream a response (token-by-token deltas):\n  const handle = synthos.agents.sendStream(agentId, message, function(event) {\n    switch (event.kind) {\n      case 'text':   // event.data = text delta string \u2014 append to output\n      case 'status': // event.data = status info object\n      case 'done':   // stream complete \u2014 stop processing\n      case 'error':  // event.data = error message string\n    }\n  });\n  handle.close(); // call to abort the stream early\n\nStream with attachments:\n  synthos.agents.sendStream(agentId, message, onEvent, [\n    { fileName: 'doc.pdf', mimeType: 'application/pdf', content: '<base64>' }\n  ]);\n\nIMPORTANT: Always check synthos.agents.list({ enabled: true }) before calling an agent.\nIf no agents are configured, show the user a link to Settings > Agents (/settings?tab=agents).";
+export declare const DEFAULT_ROUTE_HINTS: Map<string, string>;
+/**
+ * Assemble the <SERVER_APIS> prompt block, including only hints for enabled
+ * feature groups and any custom route hints from the Customizer.
+ */
+export declare function buildRouteHints(customizer: Customizer): string;
+export declare const serverAPIs = "<SERVER_APIS>\nGET /api/data/:page/:table\ndescription: Retrieve all rows from a page-scoped table (tables are stored per-page). Supports pagination via query params.\nquery params: limit (number, optional) \u2014 max rows to return; offset (number, optional, default 0) \u2014 rows to skip\nresponse (without limit): Array of JSON rows [{ id: string, ... }]\nresponse (with limit): { items: [{ id: string, ... }], total: number, offset: number, limit: number, hasMore: boolean }\n\nGET /api/data/:page/:table/:id\ndescription: Retrieve a single row from a page-scoped table\nresponse: JSON row { id: string, ... }\n\nPOST /api/data/:page/:table\ndescription: Replaces or adds a single row to a page-scoped table and returns the row\nrequest: JSON row { id?: string, ... }\nresponse: { id: string, ... }\n\nDELETE /api/data/:page/:table/:id\ndescription: Delete a single row from a page-scoped table\nresponse: { success: true }\n\nPOST /api/generate/image\ndescription: Generate an image based on a prompt\nrequest: { prompt: string, shape: 'square' | 'portrait' | 'landscape', style: 'vivid' | 'natural' }\nresponse: { url: string }\n\nPOST /api/generate/completion\ndescription: Generates a text completion based on a prompt\nrequest: { prompt: string, temperature?: number }\nresponse: { answer: string, explanation: string }\n\nGET /api/pages\ndescription: Retrieve a list of all pages with metadata\nresponse: Array of { name: string, title: string, categories: string[], pinned: boolean, createdDate: string, lastModified: string, pageVersion: number, mode: 'unlocked' | 'locked' }\n\nGET /api/pages/:name\ndescription: Retrieve metadata for a single page\nresponse: { title: string, categories: string[], pinned: boolean, createdDate: string, lastModified: string, pageVersion: number, mode: 'unlocked' | 'locked' }\n\nPOST /api/pages/:name\ndescription: Update page metadata (merge semantics \u2014 send only fields to change; lastModified is auto-set)\nrequest: { title?: string, categories?: string[], pinned?: boolean, mode?: 'unlocked' | 'locked' }\nresponse: Full metadata object\n\nDELETE /api/pages/:name\ndescription: Delete a user page (cannot delete required/system pages)\nresponse: { deleted: true }\n\nPOST /api/pages/:name/ask\ndescription: Ask a question about a page with full HTML context\nrequest: { question: string }\nresponse: { answer: string }\n\nPOST /api/scripts/:id\ndescription: Execute a script with the passed in variables\nrequest: { [key: string]: string }\nresponse: string\n\nPOST /api/search/web\ndescription: Search the web using Brave Search (must be enabled in Settings > Connectors)\nrequest: { query: string, count?: number, country?: string, freshness?: string }\nresponse: { results: [{ title: string, url: string, description: string }] }\n\nGET /api/agents\ndescription: List configured agents (A2A and OpenClaw). Supports ?enabled=true and ?provider=a2a|openclaw filters.\nresponse: [{ id: string, name: string, description: string, url: string, enabled: boolean, provider: 'a2a'|'openclaw', capabilities?: object }]\n\nPOST /api/agents/:id/send\ndescription: Send a text message to an agent (works for both A2A and OpenClaw protocols) and receive a normalized response\nrequest: { message: string, attachments?: [{ fileName: string, mimeType: string, content: string }] }\nresponse: { kind: 'message'|'task', text?: string, raw: object }\n\nPOST /api/agents/:id/stream\ndescription: Send a message and receive a streaming SSE response (text/event-stream). Each event is JSON: { kind: 'text'|'status'|'artifact'|'done'|'error', data: any }\nrequest: { message: string, attachments?: [{ fileName: string, mimeType: string, content: string }] }\nresponse: SSE stream\n\nGET /api/connectors\ndescription: List available connectors (REST API proxies). Supports ?category=X and ?id=X filters.\nresponse: [{ id: string, name: string, category: string, configured: boolean }]\n\nGET /api/connectors/:id\ndescription: Get full detail for a connector including its definition and configuration status\nresponse: { id, name, category, description, baseUrl, authStrategy, authKey, fields, configured, enabled, hasKey }\n\nPOST /api/connectors (proxy call)\ndescription: Proxy a request through a configured connector. The connector attaches auth automatically.\nrequest: { connector: string, method: string, path: string, headers?: object, body?: any, query?: object }\nresponse: Upstream API response (JSON or text)\n\nPAGE HELPERS (available globally as window.synthos):\n  synthos.data.list(table, opts?)       \u2014 GET /api/data/:page/:table  (auto-scoped to current page; opts: { limit?, offset? } \u2014 when limit is set, returns { items, total, offset, limit, hasMore })\n  synthos.data.get(table, id)           \u2014 GET /api/data/:page/:table/:id  (auto-scoped to current page)\n  synthos.data.save(table, row)         \u2014 POST /api/data/:page/:table  (auto-scoped to current page)\n  synthos.data.remove(table, id)        \u2014 DELETE /api/data/:page/:table/:id  (auto-scoped to current page)\n  synthos.generate.image({ prompt, shape, style })       \u2014 POST /api/generate/image\n  synthos.generate.completion({ prompt, temperature? })  \u2014 POST /api/generate/completion\n  synthos.scripts.run(id, variables)    \u2014 POST /api/scripts/:id\n  synthos.pages.list()                  \u2014 GET /api/pages\n  synthos.pages.get(name)               \u2014 GET /api/pages/:name\n  synthos.pages.update(name, metadata)  \u2014 POST /api/pages/:name\n  synthos.pages.remove(name)            \u2014 DELETE /api/pages/:name\n  synthos.pages.ask(name, question)     \u2014 POST /api/pages/:name/ask\n  synthos.search.web(query, opts?)      \u2014 POST /api/search/web  (opts: { count?, country?, freshness? })\n  synthos.connectors.call(connector, method, path, opts?) \u2014 POST /api/connectors  (proxy call; opts: { headers?, body?, query? })\n  synthos.connectors.list(opts?)        \u2014 GET /api/connectors  (opts: { category?, id? })\n  synthos.agents.list(opts?)             \u2014 GET /api/agents  (returns configured agents; opts: { enabled?, provider? }; returns [{ id, name, description, url, enabled, provider, capabilities }])\n  synthos.agents.send(agentId, message, attachments?) \u2014 POST /api/agents/:id/send  (sends a text message to any agent, returns normalized { kind, text, raw }; attachments: [{ fileName, mimeType, content }])\n  synthos.agents.sendStream(agentId, message, onEvent, attachments?) \u2014 POST /api/agents/:id/stream  (SSE streaming; onEvent receives { kind, data }; returns { close() } handle; attachments: [{ fileName, mimeType, content }])\n  synthos.agents.isEnabled(agentId)     \u2014 checks if an agent is enabled (returns Promise<boolean>)\n  synthos.agents.getCapabilities(agentId) \u2014 returns agent capabilities object (streaming, skills, etc.)\nAll methods return Promises. Prefer these helpers over raw fetch().";
 //# sourceMappingURL=transformPage.d.ts.map

package/dist/service/transformPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transformPage.d.ts","sourceRoot":"","sources":["../../src/service/transformPage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAA8B,MAAM,WAAW,CAAC;AAGnF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAsB,gBAAgB,EAAwB,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAMxC,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iBAAiB;IACjB,IAAI,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC7B,oDAAoD;IACpD,oBAAoB,CAAC,EAAE,gBAAgB,CAAC;IACxC,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,WAAW,EAAE,CAAC;CACpC;AAED,MAAM,MAAM,QAAQ,GACd;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrG;IAAE,EAAE,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,MAAM,MAAM,UAAU,GAAG,QAAQ,EAAE,CAAC;AAgBpC,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,CAkK1G;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAW/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA0F7D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBjE;AASD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAuEzE;AAmGD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBlF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAqB5D"}
+{"version":3,"file":"transformPage.d.ts","sourceRoot":"","sources":["../../src/service/transformPage.ts"],"names":[],"mappings":"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"}