feat(v3): unified step-based actions (integration branch)

.agents/capture/README.md

@@ -15,7 +15,9 @@ a test suite or required workflow: copy a script, change it, run it.
 # A throwaway capture vault with the plugin build linked and the demo fixture.
 pnpm exec obsidian-e2e provision --root /tmp/qa-capture --vault Notes \
   --data .agents/capture/demo-data.json
-rm /tmp/qa-capture/Notes/.obsidian/core-plugins.json   # [] disables the command palette
+# provision writes core-plugins.json as [], which turns the command palette off;
+# removing the file brings Obsidian's defaults back, palette included.
+rm /tmp/qa-capture/Notes/.obsidian/core-plugins.json
 printf '# Inbox\n\n- Buy oat milk\n' > /tmp/qa-capture/Notes/Inbox.md
 
 # A dedicated instance (never the E2E test instance) on CDP port 9333, DPR 2.

.agents/capture/ai-demo-data.json

@@ -0,0 +1,49 @@
+{
+	"disableOnlineFeatures": false,
+	"ai": {
+		"defaultModel": "demo",
+		"defaultSystemPrompt": "As an AI assistant within Obsidian, your primary goal is to help users manage their ideas and knowledge more effectively. Format your responses using Markdown syntax. Please use the [[Obsidian]] link format. You can write aliases for the links by writing [[Obsidian|the alias after the pipe symbol]]. To use mathematical notation, use LaTeX syntax. LaTeX syntax for larger equations should be on separate lines, surrounded with double dollar signs ($$). You can also inline math expressions by wrapping it in $ symbols. For example, use $$w_{ij}^{\\text{new}}:=w_{ij}^{\\text{current}}+\\eta\\cdot\\delta_j\\cdot x_{ij}$$ on a separate line, but you can write \"($\\eta$ = learning rate, $\\delta_j$ = error term, $x_{ij}$ = input)\" inline.",
+		"promptTemplatesFolderPath": "AI prompts",
+		"showAssistant": true,
+		"providers": [
+			{
+				"id": "local-demo",
+				"name": "Local demo",
+				"endpoint": "http://127.0.0.1:18431/v1",
+				"kind": "openai",
+				"apiKey": "",
+				"models": [
+					{
+						"name": "demo",
+						"maxTokens": 1050000,
+						"maxOutputTokens": 128000,
+						"supportsTemperature": false
+					}
+				],
+				"autoSyncModels": false,
+				"modelSource": "modelsDev",
+				"apiKeyRef": "local-demo-api-key"
+			}
+		],
+		"confirmToolCalls": "destructive"
+	},
+	"actions": [],
+	"migrations": {
+		"useQuickAddTemplateFolder": true,
+		"incrementFileNameSettingMoveToDefaultBehavior": true,
+		"consolidateFileExistsBehavior": true,
+		"repairTemplateFileExistsBehavior": true,
+		"mutualExclusionInsertAfterAndWriteToBottomOfFile": true,
+		"setVersionAfterUpdateModalRelease": true,
+		"addDefaultAIProviders": true,
+		"removeMacroIndirection": true,
+		"migrateFileOpeningSettings": true,
+		"backfillFileOpeningDefaults": true,
+		"setProviderModelDiscoveryMode": true,
+		"migrateProviderApiKeysToSecretStorage": true,
+		"migrateToMultipleTemplateFolders": true,
+		"refreshStaleDefaultModelSeeds": true,
+		"pinAiModelRefs": true,
+		"migrateToV3Actions": true
+	}
+}

.agents/capture/ai-demo-stub.mjs

@@ -0,0 +1,19 @@
+// A local OpenAI-compatible server with one canned reply, for the
+// AI_Assistant_Macro.gif recording (see record-ai-summarize-macro.sh).
+import http from "node:http";
+const reply = "The team will freeze scope on Friday, run a bug bash on Tuesday, and ship the release candidate to beta users on Thursday, with Priya on the launch checklist and Tom on the announcement post.";
+http.createServer((req, res) => {
+	let body = "";
+	req.on("data", (c) => (body += c));
+	req.on("end", () => {
+		console.log(req.method, req.url);
+		res.setHeader("Content-Type", "application/json");
+		if (req.url.endsWith("/models")) return res.end(JSON.stringify({ data: [{ id: "demo", object: "model" }] }));
+		const model = (() => { try { return JSON.parse(body).model; } catch { return "demo"; } })();
+		setTimeout(() => res.end(JSON.stringify({
+			id: "chatcmpl-demo", object: "chat.completion", created: Math.floor(Date.now() / 1000), model,
+			choices: [{ index: 0, message: { role: "assistant", content: reply }, finish_reason: "stop" }],
+			usage: { prompt_tokens: 120, completion_tokens: 30, total_tokens: 150 },
+		})), 900);
+	});
+}).listen(18431, "127.0.0.1", () => console.log("stub on 18431"));

.agents/capture/journal-data.json

@@ -0,0 +1,186 @@
+{
+	"actions": [
+		{
+			"kind": "action",
+			"id": "06363c82-8a27-49b9-a6dd-a9ca296c5dbd",
+			"name": "Add to journal",
+			"icon": "pencil",
+			"steps": [
+				{
+					"id": "06363c82-8a27-49b9-a6dd-a9ca296c5dbd",
+					"type": "addToNote",
+					"captureTo": "Journal/{{DATE}}.md",
+					"captureToActiveFile": false,
+					"captureToCanvasNodeId": "",
+					"position": "bottom",
+					"format": {
+						"enabled": true,
+						"format": "- {{DATE:HH:mm}} {{VALUE}}"
+					},
+					"insertAfter": {
+						"after": "",
+						"insertAtEnd": true,
+						"considerSubsections": false,
+						"createIfNotFound": true,
+						"createIfNotFoundLocation": "top",
+						"inline": false,
+						"replaceExisting": false,
+						"blankLineAfterMatchMode": "auto",
+						"promptHeading": false
+					},
+					"insertBefore": {
+						"before": "",
+						"createIfNotFound": false,
+						"createIfNotFoundLocation": "top"
+					},
+					"createFileIfItDoesntExist": {
+						"enabled": true,
+						"createWithTemplate": false,
+						"template": ""
+					},
+					"task": false
+				}
+			],
+			"show": {
+				"command": false
+			}
+		},
+		{
+			"kind": "action",
+			"id": "b65527c1-cf1e-4d91-ab15-04805cd8ea2b",
+			"name": "Task",
+			"icon": "check-square",
+			"steps": [
+				{
+					"id": "b65527c1-cf1e-4d91-ab15-04805cd8ea2b",
+					"type": "addToNote",
+					"captureTo": "{{DAILY}}",
+					"captureToActiveFile": false,
+					"captureToCanvasNodeId": "",
+					"position": "after",
+					"format": {
+						"enabled": false,
+						"format": ""
+					},
+					"insertAfter": {
+						"after": "## Tasks",
+						"insertAtEnd": true,
+						"considerSubsections": false,
+						"createIfNotFound": true,
+						"createIfNotFoundLocation": "bottom",
+						"inline": false,
+						"replaceExisting": false,
+						"blankLineAfterMatchMode": "auto",
+						"promptHeading": false
+					},
+					"insertBefore": {
+						"before": "",
+						"createIfNotFound": false,
+						"createIfNotFoundLocation": "top"
+					},
+					"createFileIfItDoesntExist": {
+						"enabled": true,
+						"createWithTemplate": false,
+						"template": ""
+					},
+					"task": true
+				}
+			],
+			"show": {
+				"command": false
+			}
+		},
+		{
+			"kind": "action",
+			"id": "8e90f6ee-ed9a-401f-a217-daf0f293e926",
+			"name": "New note",
+			"icon": "file-plus",
+			"steps": [
+				{
+					"id": "8e90f6ee-ed9a-401f-a217-daf0f293e926",
+					"type": "createNote",
+					"templatePath": "",
+					"fileNameFormat": {
+						"enabled": false,
+						"format": ""
+					},
+					"location": {
+						"mode": "default",
+						"folders": [],
+						"includeSubfolders": false
+					},
+					"fileExistsBehavior": {
+						"kind": "prompt"
+					},
+					"discoverExistingNotesBeforeCreate": false
+				}
+			],
+			"show": {
+				"command": false
+			}
+		},
+		{
+			"kind": "action",
+			"id": "54659787-b136-46d2-962c-6cf5cbf0bdfc",
+			"name": "Log",
+			"icon": "clock",
+			"steps": [
+				{
+					"id": "54659787-b136-46d2-962c-6cf5cbf0bdfc",
+					"type": "addToNote",
+					"captureTo": "{{DAILY}}",
+					"captureToActiveFile": false,
+					"captureToCanvasNodeId": "",
+					"position": "after",
+					"format": {
+						"enabled": true,
+						"format": "- {{TIME}} {{VALUE}}"
+					},
+					"insertAfter": {
+						"after": "## Log",
+						"insertAtEnd": true,
+						"considerSubsections": false,
+						"createIfNotFound": true,
+						"createIfNotFoundLocation": "bottom",
+						"inline": false,
+						"replaceExisting": false,
+						"blankLineAfterMatchMode": "auto",
+						"promptHeading": false
+					},
+					"insertBefore": {
+						"before": "",
+						"createIfNotFound": false,
+						"createIfNotFoundLocation": "top"
+					},
+					"createFileIfItDoesntExist": {
+						"enabled": true,
+						"createWithTemplate": false,
+						"template": ""
+					},
+					"task": false
+				}
+			],
+			"show": {
+				"command": false
+			}
+		}
+	],
+	"migrations": {
+		"useQuickAddTemplateFolder": true,
+		"incrementFileNameSettingMoveToDefaultBehavior": true,
+		"consolidateFileExistsBehavior": true,
+		"repairTemplateFileExistsBehavior": true,
+		"mutualExclusionInsertAfterAndWriteToBottomOfFile": true,
+		"setVersionAfterUpdateModalRelease": true,
+		"addDefaultAIProviders": true,
+		"removeMacroIndirection": true,
+		"migrateFileOpeningSettings": true,
+		"backfillFileOpeningDefaults": true,
+		"setProviderModelDiscoveryMode": true,
+		"migrateProviderApiKeysToSecretStorage": true,
+		"migrateToMultipleTemplateFolders": true,
+		"refreshStaleDefaultModelSeeds": true,
+		"pinAiModelRefs": true,
+		"migrateToV3Actions": true
+	}
+}

.agents/capture/record-add-to-journal.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# Drive the Getting Started "Add to journal" Capture choice the way a user would,
+# for docs/src/content/docs/docs/Images/getting-started-add-to-journal.gif.
+# journal-data.json holds the choice as the page's steps make it from the
+# "Add to a note" preset, next to the Task, New note and Log presets.
+#
+#   pnpm exec obsidian-e2e provision --root /tmp/qa-capture --vault Notes \
+#     --data .agents/capture/journal-data.json
+#   rm /tmp/qa-capture/Notes/.obsidian/core-plugins.json   # the defaults, command palette included
+#   mkdir -p /tmp/qa-capture/Notes/{Areas,Journal,Meetings,People,Projects,Templates}
+#   printf -- '- 08:10 Morning run along the harbour, 5 km\n- 08:45 Coffee and weekly planning\n' \
+#     > "/tmp/qa-capture/Notes/Journal/$(date +%F).md"
+#   # launch and prepare as in README.md, open the file explorer, then:
+#   obsidian-e2e capture record journal.webm --cursor -- .agents/capture/record-add-to-journal.sh
+set -euo pipefail
+
+: "${OBSIDIAN_E2E_CDP_PORT:?run under obsidian-e2e capture record}"
+: "${OBSIDIAN_E2E_CAPTURE_VAULT_PATH:?export the capture launch --print-env output}"
+export AGENT_BROWSER_SESSION="${AGENT_BROWSER_SESSION:-quickadd-capture}"
+ab() { agent-browser --cdp "$OBSIDIAN_E2E_CDP_PORT" "$@" >/dev/null; }
+cap() { obsidian-e2e capture "$@"; }
+text="Standup moved to Wednesday"
+journal="$OBSIDIAN_E2E_CAPTURE_VAULT_PATH/Journal/$(date +%F).md"
+[[ -f "$journal" ]] || { echo "Seed $journal with a few entries first" >&2; exit 1; }
+before=$(grep -c "" "$journal")
+
+ab eval "app.workspace.openLinkText('Journal/$(date +%F)', '', false).then(() => app.workspace.activeEditor?.editor?.blur?.())"
+ab mouse move 1180 740
+sleep 1.5
+ab press Control+p
+sleep 0.5
+cap type "QuickAdd: Run" --delay 60 --selector ".prompt-input"
+sleep 0.5
+ab press Enter
+sleep 0.9
+cap type "jour" --delay 90 --selector ".prompt-input"
+sleep 0.5
+ab press Enter
+sleep 0.8
+cap type "$text" --delay 45
+sleep 0.6
+ab press Enter
+
+# Verify the product behaviour, not just the pixels: the entry is a new last
+# line of today's journal note, as the Getting Started page says.
+entry="^- [0-9]{2}:[0-9]{2} $text\$"
+for _ in $(seq 1 30); do
+	(( $(grep -c "" "$journal") > before )) && tail -n 1 "$journal" | grep -Eq "$entry" && break
+	sleep 0.2
+done
+tail -n 1 "$journal" | grep -Eq "$entry" && (( $(grep -c "" "$journal") > before )) || {
+	echo "QuickAdd did not add a new last line to $journal" >&2
+	exit 1
+}
+sleep 2.5