framer-dalton 0.0.16 → 0.0.17

package/dist/cli.js

@@ -10,7 +10,7 @@ import { z } from 'zod';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.16 */
+/* @framer/ai CLI v0.0.17 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 function openUrl(url) {
@@ -538,6 +538,121 @@ var types = {
       }
     ]
   },
+  agentclarificationanswer: {
+    name: "AgentClarificationAnswer",
+    description: "",
+    kind: "interface",
+    references: ["AgentClarificationSuggestedAnswer"],
+    members: [
+      {
+        name: "questionIndex",
+        type: "number",
+        description: "",
+        optional: false
+      },
+      {
+        name: "answer",
+        type: "AgentClarificationSuggestedAnswer",
+        description: "",
+        optional: false
+      }
+    ]
+  },
+  agentclarificationquestion: {
+    name: "AgentClarificationQuestion",
+    description: "",
+    kind: "interface",
+    references: ["AgentClarificationSuggestedAnswer"],
+    members: [
+      {
+        name: "question",
+        type: "string",
+        description: "",
+        optional: false
+      },
+      {
+        name: "suggestedAnswers",
+        type: "readonly AgentClarificationSuggestedAnswer[]",
+        description: "",
+        optional: false
+      }
+    ]
+  },
+  agentclarificationsuggestedanswer: {
+    name: "AgentClarificationSuggestedAnswer",
+    description: "",
+    kind: "alias",
+    alias: "string | AgentClarificationSuggestedAnswerWithDescription",
+    references: ["AgentClarificationSuggestedAnswerWithDescription"]
+  },
+  agentclarificationsuggestedanswerwithdescription: {
+    name: "AgentClarificationSuggestedAnswerWithDescription",
+    description: "",
+    kind: "interface",
+    references: [],
+    members: [
+      {
+        name: "answer",
+        type: "string",
+        description: "",
+        optional: false
+      },
+      {
+        name: "description",
+        type: "string",
+        description: "",
+        optional: false
+      }
+    ]
+  },
+  agentconversationcompletedresult: {
+    name: "AgentConversationCompletedResult",
+    description: "",
+    kind: "interface",
+    references: [],
+    members: [
+      {
+        name: "responseMessages",
+        type: "readonly unknown[]",
+        description: "",
+        optional: false
+      }
+    ]
+  },
+  agentconversationneedsclarificationresult: {
+    name: "AgentConversationNeedsClarificationResult",
+    description: "",
+    kind: "interface",
+    references: ["AgentClarificationQuestion"],
+    members: [
+      {
+        name: "clarificationQuestions",
+        type: "readonly AgentClarificationQuestion[]",
+        description: "",
+        optional: false
+      }
+    ]
+  },
+  agentturnoptions: {
+    name: "AgentTurnOptions",
+    description: "",
+    kind: "interface",
+    references: [],
+    members: [
+      {
+        name: "selectionNodeIds",
+        type: "readonly string[]",
+        description: "Treat these nodes as the implicit selection for this agent turn.\n\nWhen provided, all node ids must exist. If a node is not currently loaded in the session, it may not be found.",
+        optional: true
+      },
+      {
+        name: "imageUrls",
+        type: "readonly string[]",
+        description: "Attach images to this agent turn by URL.\n\nURLs can be external or existing Framer asset URLs. They will be ingested into the\nproject's assets if needed, then sent to the model as image parts.\n\nTip: if you have a local file (or bytes), upload it first (e.g. `framer.uploadImage(...)`) and\npass the returned asset URL here.",
+        optional: true
+      }
+    ]
+  },
   aiserviceinfo: {
     name: "AiServiceInfo",
     description: "",
@@ -1809,6 +1924,31 @@ var types = {
       }
     ]
   },
+  continueagentconversationoptions: {
+    name: "ContinueAgentConversationOptions",
+    description: "",
+    kind: "interface",
+    references: ["AgentTurnOptions"],
+    members: [
+      {
+        name: "conversationId",
+        type: "string",
+        description: "Existing agent conversation to continue.",
+        optional: false
+      }
+    ],
+    extends: ["AgentTurnOptions"]
+  },
+  continueagentconversationresult: {
+    name: "ContinueAgentConversationResult",
+    description: "",
+    kind: "alias",
+    alias: "AgentConversationCompletedResult | AgentConversationNeedsClarificationResult",
+    references: [
+      "AgentConversationCompletedResult",
+      "AgentConversationNeedsClarificationResult"
+    ]
+  },
   control: {
     name: "Control",
     description: "",
@@ -6639,6 +6779,24 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "startAgentConversation",
+        type: "(prompt: string, options?: StartAgentConversationOptions) => Promise<StartAgentConversationResult>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "continueAgentConversation",
+        type: "(prompt: string, options: ContinueAgentConversationOptions) => Promise<ContinueAgentConversationResult>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "submitAgentClarification",
+        type: "(options: SubmitAgentClarificationOptions) => Promise<SubmitAgentClarificationResult>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "[getAiServiceInfoMessageType]",
         type: "() => Promise<AiServiceInfo>",
@@ -7412,6 +7570,31 @@ var types = {
       }
     ]
   },
+  startagentconversationoptions: {
+    name: "StartAgentConversationOptions",
+    description: "",
+    kind: "interface",
+    references: ["AgentTurnOptions"],
+    members: [
+      {
+        name: "pagePath",
+        type: "string",
+        description: 'Target page path (e.g. `"/about"`). Defaults to the active page.',
+        optional: true
+      }
+    ],
+    extends: ["AgentTurnOptions"]
+  },
+  startagentconversationresult: {
+    name: "StartAgentConversationResult",
+    description: "",
+    kind: "alias",
+    alias: "({\n    conversationId: string;\n} & AgentConversationCompletedResult) | ({\n    conversationId: string;\n} & AgentConversationNeedsClarificationResult)",
+    references: [
+      "AgentConversationCompletedResult",
+      "AgentConversationNeedsClarificationResult"
+    ]
+  },
   stringcontrol: {
     name: "StringControl",
     description: "",
@@ -7543,6 +7726,33 @@ var types = {
       "WithStringDefaultValue"
     ]
   },
+  submitagentclarificationoptions: {
+    name: "SubmitAgentClarificationOptions",
+    description: "",
+    kind: "interface",
+    references: ["AgentClarificationAnswer"],
+    members: [
+      {
+        name: "conversationId",
+        type: "string",
+        description: "",
+        optional: false
+      },
+      {
+        name: "answers",
+        type: "AgentClarificationAnswer[]",
+        description: "",
+        optional: false
+      }
+    ]
+  },
+  submitagentclarificationresult: {
+    name: "SubmitAgentClarificationResult",
+    description: "",
+    kind: "alias",
+    alias: "ContinueAgentConversationResult",
+    references: ["ContinueAgentConversationResult"]
+  },
   supportedfielddefinitiondata: {
     name: "SupportedFieldDefinitionData",
     description: "A collection field that Framer knows about and the plugin API fully supports.",
@@ -12377,6 +12587,16 @@ var methodsByCategory = {
       description: "Clone a node.",
       references: ["AnyNode"]
     },
+    {
+      name: "continueAgentConversation",
+      category: "framer",
+      signature: "continueAgentConversation(prompt: string, options: ContinueAgentConversationOptions): Promise<ContinueAgentConversationResult>",
+      description: "",
+      references: [
+        "ContinueAgentConversationOptions",
+        "ContinueAgentConversationResult"
+      ]
+    },
     {
       name: "createCodeFile",
       category: "framer",
@@ -12853,6 +13073,26 @@ var methodsByCategory = {
       description: "Set the text of the current selection or insert it onto the canvas.",
       references: []
     },
+    {
+      name: "startAgentConversation",
+      category: "framer",
+      signature: "startAgentConversation(prompt: string, options?: StartAgentConversationOptions): Promise<StartAgentConversationResult>",
+      description: "",
+      references: [
+        "StartAgentConversationOptions",
+        "StartAgentConversationResult"
+      ]
+    },
+    {
+      name: "submitAgentClarification",
+      category: "framer",
+      signature: "submitAgentClarification(options: SubmitAgentClarificationOptions): Promise<SubmitAgentClarificationResult>",
+      description: "",
+      references: [
+        "SubmitAgentClarificationOptions",
+        "SubmitAgentClarificationResult"
+      ]
+    },
     {
       name: "typecheckCode",
       category: "framer",
@@ -14982,7 +15222,7 @@ __name(renderDocs, "renderDocs");
 // src/version.ts
 var VERSION = (
   // typeof is used to ensure this can be used just via tsx or node etc. without build
-  "0.0.16" 
+  "0.0.17" 
 );
 
 // src/relay-client.ts

package/dist/start-relay-server.js

@@ -13,7 +13,7 @@ import { createRequire } from 'module';
 import * as vm from 'vm';
 import { connect } from 'framer-api';
 
-/* @framer/ai relay server v0.0.16 */
+/* @framer/ai relay server v0.0.17 */
 var __defProp = Object.defineProperty;
 var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
 var __typeError = (msg) => {
@@ -93,7 +93,7 @@ __name(log, "log");
 // src/version.ts
 var VERSION = (
   // typeof is used to ensure this can be used just via tsx or node etc. without build
-  "0.0.16" 
+  "0.0.17" 
 );
 
 // src/relay-client.ts

package/docs/skills/framer.md

@@ -146,6 +146,42 @@ For design tasks, do not try to build or restyle pages with low-level node APIs.
 
 After session creation, load the dynamically created project-scoped skill `framer-canvas-editing-project-<projectId>` for canvas editing on the connected project. It contains the canvas editing guidance, the live agent system prompt, and the live project context for `pagePath: "/"`.
 
+Do not call `framer.startAgentConversation()` or `framer.continueAgentConversation()` with this approach.
+
+## Canvas Editing: Alternative Approach (“Prompt the Framer agent”)
+
+Use this approach only if the user asks for it. Do not mention this approach to the user otherwise.
+
+This approach is called “Prompt the Framer agent”. With this approach, use `framer.startAgentConversation()` to start a stateful design subagent. Keep the `conversationId` it returns in `state`, and call `framer.continueAgentConversation()` with it to continue the same design task.
+
+Do not call `framer.getAgentSystemPrompt()` or `framer.getAgentContext()` or `framer.applyAgentChanges()` with this approach.
+
+Example:
+
+```js
+state.agent ??= {};
+const first = await framer.startAgentConversation(
+  "Build me a landing page based on the attached screenshot",
+  {
+    pagePath: "/",
+    imageUrls: ["https://example.com/image.png"],
+    // selectionNodeIds: [...]
+  },
+);
+state.agent.conversationId = first.conversationId;
+console.log(first.responseMessages);
+
+const second = await framer.continueAgentConversation("Now make it pink", {
+  conversationId: state.agent.conversationId,
+  selectionNodeIds: ["someNodeId"],
+  // imageUrls: [...],
+  // changing pagePath or model is not supported
+});
+console.log(second.responseMessages);
+```
+
+Prompting may take a while to complete, so set the command timeout to 10 minutes.
+
 ## Execute Code
 
 Write your code to a unique file under `{{FRAMER_TEMPORARY_DIR}}/` and execute with `-f`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framer-dalton",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "type": "module",
   "bin": {
     "framer-dalton": "./dist/cli.js"
@@ -25,7 +25,7 @@
     "@trpc/client": "^11.9.0",
     "@trpc/server": "^11.9.0",
     "commander": "^12.1.0",
-    "framer-api": "^0.1.4",
+    "framer-api": "^0.1.4-alpha.1",
     "zod": "^4.3.6"
   },
   "devDependencies": {