@pellux/goodvibes-agent 0.1.116 → 1.0.0

package/src/input/agent-workspace-channel-command-editor-submission.ts

@@ -0,0 +1,83 @@
+import type { AgentWorkspaceActionResult, AgentWorkspaceEditorKind, AgentWorkspaceLocalEditor } from './agent-workspace-types.ts';
+import type { AgentWorkspaceChannelCommandEditorKind } from './agent-workspace-channel-command-editors.ts';
+import { isAgentWorkspaceChannelCommandEditorKind } from './agent-workspace-channel-command-editors.ts';
+import { quoteSlashCommandArg } from './slash-command-parser.ts';
+
+type AgentWorkspaceFieldReader = (fieldId: string) => string;
+
+export type AgentWorkspaceChannelCommandEditorSubmission =
+  | {
+    readonly kind: 'editor';
+    readonly editor: AgentWorkspaceLocalEditor;
+    readonly status: string;
+    readonly actionResult?: AgentWorkspaceActionResult;
+  }
+  | {
+    readonly kind: 'dispatch';
+    readonly command: string;
+    readonly status: string;
+    readonly actionResult: AgentWorkspaceActionResult;
+  };
+
+export function isAgentWorkspaceChannelCommandSubmissionKind(kind: AgentWorkspaceEditorKind): kind is AgentWorkspaceChannelCommandEditorKind {
+  return isAgentWorkspaceChannelCommandEditorKind(kind);
+}
+
+export function buildAgentWorkspaceChannelCommandEditorSubmission(
+  editor: AgentWorkspaceLocalEditor,
+  readField: AgentWorkspaceFieldReader,
+): AgentWorkspaceChannelCommandEditorSubmission {
+  if (editor.kind === 'channel-send') {
+    if (!/^(y|yes|true)$/i.test(readField('confirm').trim())) {
+      return {
+        kind: 'editor',
+        editor: { ...editor, message: 'Channel delivery not confirmed. Type yes, then press Enter.' },
+        status: 'Channel delivery not confirmed.',
+      };
+    }
+    const parts = ['/channels', 'send'];
+    const title = readField('title');
+    const channel = readField('channel');
+    const route = readField('route');
+    const webhook = readField('webhook');
+    const link = readField('link');
+    if (title) parts.push('--title', quoteSlashCommandArg(title));
+    if (channel) parts.push('--channel', quoteSlashCommandArg(channel));
+    if (route) parts.push('--route', quoteSlashCommandArg(route));
+    if (webhook) parts.push('--webhook', quoteSlashCommandArg(webhook));
+    if (link) parts.push('--link', quoteSlashCommandArg(link));
+    parts.push('--message', quoteSlashCommandArg(readField('message')), '--yes');
+    const command = parts.join(' ');
+    return {
+      kind: 'dispatch',
+      command,
+      status: 'Opening channel delivery.',
+      actionResult: {
+        kind: 'dispatched',
+        title: 'Opening channel delivery',
+        detail: 'The workspace handed a confirmed channel delivery command to the shell-owned command router.',
+        command,
+        safety: 'safe',
+      },
+    };
+  }
+  const subcommand = editor.kind === 'channel-doctor' ? 'doctor' : editor.kind === 'channel-setup' ? 'setup' : 'show';
+  const command = `/channels ${subcommand} ${quoteSlashCommandArg(readField('channel'))}`;
+  const title = editor.kind === 'channel-doctor'
+    ? 'Opening channel doctor'
+    : editor.kind === 'channel-setup'
+      ? 'Opening channel setup guidance'
+      : 'Opening channel detail';
+  return {
+    kind: 'dispatch',
+    command,
+    status: `${title}.`,
+    actionResult: {
+      kind: 'dispatched',
+      title,
+      detail: 'The workspace handed read-only channel inspection to the shell-owned command router.',
+      command,
+      safety: 'read-only',
+    },
+  };
+}

package/src/input/agent-workspace-channel-command-editors.ts

@@ -0,0 +1,65 @@
+import type { AgentWorkspaceEditorKind, AgentWorkspaceLocalEditor } from './agent-workspace-types.ts';
+
+export type AgentWorkspaceChannelCommandEditorKind = Extract<
+  AgentWorkspaceEditorKind,
+  'channel-show' | 'channel-doctor' | 'channel-setup' | 'channel-send'
+>;
+
+export function isAgentWorkspaceChannelCommandEditorKind(kind: AgentWorkspaceEditorKind): kind is AgentWorkspaceChannelCommandEditorKind {
+  return kind === 'channel-show' || kind === 'channel-doctor' || kind === 'channel-setup' || kind === 'channel-send';
+}
+
+export function createAgentWorkspaceChannelCommandEditor(kind: AgentWorkspaceChannelCommandEditorKind): AgentWorkspaceLocalEditor {
+  if (kind === 'channel-send') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Send Channel Message',
+      selectedFieldIndex: 0,
+      message: 'Send one message through a configured delivery target. Fill exactly one target field and type yes to confirm.',
+      fields: [
+        { id: 'message', label: 'Message', value: '', required: true, multiline: true, hint: 'Plain-text message. Ctrl-J inserts a new line.' },
+        { id: 'title', label: 'Title', value: '', required: false, multiline: false, hint: 'Optional delivery title. Blank uses the Agent default.' },
+        { id: 'channel', label: 'Channel target', value: '', required: false, multiline: false, hint: 'Optional surface[:route[:label]], such as slack:ops:Ops or telephony:+15551234567.' },
+        { id: 'route', label: 'Route target', value: '', required: false, multiline: false, hint: 'Optional route id or route:label.' },
+        { id: 'webhook', label: 'Webhook URL', value: '', required: false, multiline: false, hint: 'Optional http(s) webhook target.' },
+        { id: 'link', label: 'Link target', value: '', required: false, multiline: false, hint: 'Optional link delivery target.' },
+        { id: 'confirm', label: 'Confirm', value: '', required: true, multiline: false, hint: 'Type yes to run /channels send with --yes.' },
+      ],
+    };
+  }
+  if (kind === 'channel-doctor') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Run Channel Doctor',
+      selectedFieldIndex: 0,
+      message: 'Inspect one connected channel route without sending messages or changing delivery state.',
+      fields: [
+        { id: 'channel', label: 'Channel id', value: '', required: true, multiline: false, hint: 'Channel id, such as slack, telegram, discord, ntfy, signal, whatsapp, or telephony.' },
+      ],
+    };
+  }
+  if (kind === 'channel-setup') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Show Channel Setup',
+      selectedFieldIndex: 0,
+      message: 'Show read-only setup guidance for one channel. This does not pair, enable, or send through the channel.',
+      fields: [
+        { id: 'channel', label: 'Channel id', value: '', required: true, multiline: false, hint: 'Channel id, such as slack, telegram, discord, ntfy, signal, whatsapp, or telephony.' },
+      ],
+    };
+  }
+  return {
+    kind,
+    mode: 'create',
+    title: 'Show Channel Detail',
+    selectedFieldIndex: 0,
+    message: 'Show one channel readiness record from the Agent workspace without changing channel state.',
+    fields: [
+      { id: 'channel', label: 'Channel id', value: '', required: true, multiline: false, hint: 'Channel id, such as slack, telegram, discord, ntfy, signal, whatsapp, or telephony.' },
+    ],
+  };
+}

package/src/input/agent-workspace-channels.ts

@@ -29,6 +29,7 @@ interface AgentWorkspaceChannelSpec {
   readonly label: string;
   readonly enabledKey: string;
   readonly requiredKeys: readonly string[];
+  readonly requiredKeyGroups?: readonly (readonly string[])[];
   readonly defaultTargetKeys: readonly string[];
   readonly risk: AgentWorkspaceChannelRisk;
   readonly riskLabel: string;
@@ -98,6 +99,19 @@ const AGENT_WORKSPACE_CHANNEL_SPECS: readonly AgentWorkspaceChannelSpec[] = [
     risk: 'dm',
     riskLabel: 'phone-number delivery',
   },
+  {
+    id: 'telephony',
+    label: 'Telephony',
+    enabledKey: 'surfaces.telephony.enabled',
+    requiredKeys: [],
+    requiredKeyGroups: [
+      ['surfaces.telephony.bridgeUrl'],
+      ['surfaces.telephony.accountSid', 'surfaces.telephony.authToken', 'surfaces.telephony.fromNumber'],
+    ],
+    defaultTargetKeys: ['surfaces.telephony.defaultRecipient'],
+    risk: 'dm',
+    riskLabel: 'SMS/voice phone-number delivery',
+  },
   {
     id: 'imessage',
     label: 'iMessage',
@@ -186,9 +200,28 @@ function hasConfigValue(context: CommandContext, key: string): boolean {
   }
 }
 
+function uniqueStrings(values: readonly string[]): readonly string[] {
+  return [...new Set(values)];
+}
+
+function missingKeysForBestRequiredGroup(context: CommandContext, groups: readonly (readonly string[])[]): readonly string[] {
+  if (groups.length === 0) return [];
+  const missingByGroup = groups.map((group) => group.filter((key) => !hasConfigValue(context, key)));
+  if (missingByGroup.some((missing) => missing.length === 0)) return [];
+  return missingByGroup.reduce((best, missing) => missing.length < best.length ? missing : best, missingByGroup[0] ?? []);
+}
+
 function buildChannelStatus(context: CommandContext, spec: AgentWorkspaceChannelSpec): AgentWorkspaceChannelStatus {
   const enabled = readConfigBoolean(context, spec.enabledKey, false);
-  const missingRequiredKeys = spec.requiredKeys.filter((key) => !hasConfigValue(context, key));
+  const requiredKeyGroups = spec.requiredKeyGroups ?? [];
+  const requiredKeys = uniqueStrings([
+    ...spec.requiredKeys,
+    ...requiredKeyGroups.flat(),
+  ]);
+  const missingRequiredKeys = [
+    ...spec.requiredKeys.filter((key) => !hasConfigValue(context, key)),
+    ...missingKeysForBestRequiredGroup(context, requiredKeyGroups),
+  ];
   const configuredDefaultTargetKeys = spec.defaultTargetKeys.filter((key) => hasConfigValue(context, key));
   const missingConfigCount = missingRequiredKeys.length;
   const defaultTarget = spec.defaultTargetKeys.length === 0
@@ -223,7 +256,7 @@ function buildChannelStatus(context: CommandContext, spec: AgentWorkspaceChannel
     label: spec.label,
     enabled,
     ready,
-    requiredKeys: spec.requiredKeys,
+    requiredKeys,
     missingRequiredKeys,
     missingConfigCount,
     defaultTargetKeys: spec.defaultTargetKeys,

package/src/input/agent-workspace-command-editor.ts

@@ -1,23 +1,35 @@
+import type { AgentWorkspaceBasicCommandEditorKind } from './agent-workspace-basic-command-editors.ts';
 import { buildAgentWorkspaceBasicCommandEditorSubmission, isAgentWorkspaceBasicCommandEditorKind } from './agent-workspace-basic-command-editors.ts';
 import { buildAgentKnowledgeUrlEditorSubmission } from './agent-workspace-knowledge-url-editor.ts';
 import { buildAgentKnowledgeQueryEditorSubmission } from './agent-workspace-knowledge-query-editor.ts';
 import { buildAgentReminderScheduleEditorSubmission } from './agent-workspace-reminder-schedule-editor.ts';
 import { buildAgentRoutineScheduleEditorSubmission } from './agent-workspace-routine-schedule-editor.ts';
+import { buildAgentWorkspaceWebResearchSubmission } from './agent-workspace-web-research-editor.ts';
 import type { AgentWorkspaceActionResult, AgentWorkspaceEditorKind, AgentWorkspaceLocalEditor } from './agent-workspace-types.ts';
 
 type AgentWorkspaceFieldReader = (fieldId: string) => string;
-type AgentWorkspaceCommandEditorKind = Extract<
+type AgentWorkspaceCommandEditorKind = AgentWorkspaceBasicCommandEditorKind | Extract<
   AgentWorkspaceEditorKind,
-  'knowledge-url'
+  'web-research'
+  | 'web-fetch'
+  | 'knowledge-url'
+  | 'knowledge-urls'
   | 'knowledge-file'
   | 'knowledge-browser-history'
   | 'knowledge-connector-ingest'
+  | 'knowledge-reindex'
   | 'knowledge-search'
   | 'knowledge-ask'
   | 'mcp-server'
   | 'notify-webhook'
   | 'notify-webhook-remove'
+  | 'notify-webhook-clear'
   | 'notify-webhook-test'
+  | 'notify-send'
+  | 'secret-set'
+  | 'secret-link'
+  | 'secret-test'
+  | 'secret-delete'
   | 'routine-schedule'
   | 'reminder-schedule'
   | 'knowledge-bookmarks'
@@ -31,6 +43,20 @@ type AgentWorkspaceCommandEditorKind = Extract<
   | 'profile-template-import'
   | 'profile-template-from-discovered'
   | 'profile-from-discovered'
+  | 'profile-default'
+  | 'profile-default-clear'
+  | 'support-bundle-export'
+  | 'support-bundle-inspect'
+  | 'support-bundle-import'
+  | 'subscription-inspect'
+  | 'subscription-login-start'
+  | 'subscription-login-finish'
+  | 'subscription-logout'
+  | 'delegate-task'
+  | 'workplan-add'
+  | 'workplan-status'
+  | 'workplan-delete'
+  | 'workplan-clear-completed'
 >;
 
 type AgentWorkspaceCommandEditorSubmission =
@@ -45,10 +71,18 @@ type AgentWorkspaceCommandEditorSubmission =
     readonly command: string;
     readonly status: string;
     readonly actionResult: AgentWorkspaceActionResult;
+  }
+  | {
+    readonly kind: 'prompt';
+    readonly prompt: string;
+    readonly status: string;
+    readonly actionResult: AgentWorkspaceActionResult;
   };
 
 export function isAgentWorkspaceCommandEditorKind(kind: AgentWorkspaceEditorKind): kind is AgentWorkspaceCommandEditorKind {
-  return kind === 'knowledge-url'
+  return kind === 'web-research'
+    || kind === 'web-fetch'
+    || kind === 'knowledge-url'
     || kind === 'knowledge-search'
     || kind === 'knowledge-ask'
     || kind === 'routine-schedule'
@@ -60,7 +94,11 @@ export function buildAgentWorkspaceCommandEditorSubmission(
   editor: AgentWorkspaceLocalEditor,
   readField: AgentWorkspaceFieldReader,
   commandDispatchAvailable: boolean,
+  promptDispatchAvailable: boolean,
 ): AgentWorkspaceCommandEditorSubmission {
+  if (editor.kind === 'web-research' || editor.kind === 'web-fetch') {
+    return buildAgentWorkspaceWebResearchSubmission(editor, readField, promptDispatchAvailable);
+  }
   if (editor.kind === 'knowledge-url') return buildAgentKnowledgeUrlEditorSubmission(editor, readField, commandDispatchAvailable);
   if (editor.kind === 'knowledge-search' || editor.kind === 'knowledge-ask') {
     return buildAgentKnowledgeQueryEditorSubmission(editor, readField, commandDispatchAvailable);

package/src/input/agent-workspace-config-reader.ts

@@ -0,0 +1,16 @@
+import type { CommandContext } from './command-registry.ts';
+
+export interface AgentWorkspaceConfigReader {
+  get(key: string): unknown;
+}
+
+export function getAgentWorkspaceConfigReader(context: CommandContext): AgentWorkspaceConfigReader | null {
+  const configManager: object = context.platform.configManager;
+  const get = Reflect.get(configManager, 'get');
+  if (typeof get !== 'function') return null;
+  return {
+    get(key: string): unknown {
+      return Reflect.apply(get, configManager, [key]);
+    },
+  };
+}

package/src/input/agent-workspace-delegation-editor-submission.ts

@@ -0,0 +1,55 @@
+import type { AgentWorkspaceActionResult, AgentWorkspaceLocalEditor } from './agent-workspace-types.ts';
+import { quoteSlashCommandArg } from './slash-command-parser.ts';
+
+type AgentWorkspaceFieldReader = (fieldId: string) => string;
+
+export type AgentWorkspaceDelegationEditorSubmission =
+  | {
+    readonly kind: 'editor';
+    readonly editor: AgentWorkspaceLocalEditor;
+    readonly status: string;
+    readonly actionResult?: AgentWorkspaceActionResult;
+  }
+  | {
+    readonly kind: 'dispatch';
+    readonly command: string;
+    readonly status: string;
+    readonly actionResult: AgentWorkspaceActionResult;
+  };
+
+function isAffirmative(value: string): boolean {
+  return /^(y|yes|true)$/i.test(value.trim());
+}
+
+export function isAgentWorkspaceDelegationEditorKind(kind: string): kind is 'delegate-task' {
+  return kind === 'delegate-task';
+}
+
+export function buildAgentWorkspaceDelegationEditorSubmission(
+  editor: AgentWorkspaceLocalEditor,
+  readField: AgentWorkspaceFieldReader,
+): AgentWorkspaceDelegationEditorSubmission {
+  if (!isAffirmative(readField('confirm'))) {
+    return {
+      kind: 'editor',
+      editor: { ...editor, message: 'Build delegation not confirmed. Type yes, then press Enter.' },
+      status: 'Build delegation not confirmed.',
+    };
+  }
+  const parts = ['/delegate'];
+  if (isAffirmative(readField('review')) || isAffirmative(readField('wrfc'))) parts.push('--review');
+  parts.push(quoteSlashCommandArg(readField('task')));
+  const command = parts.join(' ');
+  return {
+    kind: 'dispatch',
+    command,
+    status: 'Opening explicit build delegation.',
+    actionResult: {
+      kind: 'dispatched',
+      title: 'Opening explicit build delegation',
+      detail: 'The workspace handed a confirmed build/fix/review task to the shell-owned command router.',
+      command,
+      safety: 'delegates',
+    },
+  };
+}

package/src/input/agent-workspace-editors.ts

@@ -1,6 +1,7 @@
 import type { AgentPersonaRecord } from '../agent/persona-registry.ts';
 import type { AgentRoutineRecord } from '../agent/routine-registry.ts';
 import type { AgentSkillRecord } from '../agent/skill-registry.ts';
+import type { AgentNoteRecord } from '../agent/note-registry.ts';
 import type { MemoryRecord } from '@pellux/goodvibes-sdk/platform/state';
 import type {
   AgentWorkspaceLocalEditor,
@@ -30,6 +31,25 @@ export function createProfileEditor(templates: readonly AgentWorkspaceRuntimeSta
   };
 }
 
+export function createLearnedBehaviorEditor(): AgentWorkspaceLocalEditor {
+  return {
+    kind: 'learned-behavior',
+    mode: 'create',
+    title: 'Capture Learned Behavior',
+    selectedFieldIndex: 0,
+    message: 'Turn a reviewed workflow or lesson into Agent-local behavior. This writes only to Agent-local personas, skills, or routines.',
+    fields: [
+      { id: 'target', label: 'Behavior type', value: 'skill', required: true, multiline: false, hint: 'skill, routine, or persona.' },
+      { id: 'name', label: 'Name', value: '', required: true, multiline: false, hint: 'Short name for the learned behavior.' },
+      { id: 'description', label: 'Description', value: '', required: true, multiline: false, hint: 'One-line summary of when to use it.' },
+      { id: 'notes', label: 'Lesson or workflow', value: '', required: true, multiline: true, hint: 'Paste the procedure, persona guidance, or repeatable workflow. Ctrl-J inserts a new line.' },
+      { id: 'triggers', label: 'Triggers', value: '', required: false, multiline: false, hint: 'Comma-separated words that suggest this behavior.' },
+      { id: 'tags', label: 'Tags', value: 'learned', required: false, multiline: false, hint: 'Comma-separated optional tags.' },
+      { id: 'enable', label: 'Enable or activate', value: 'yes', required: false, multiline: false, hint: 'yes/no. Skills and routines enable; personas activate.' },
+    ],
+  };
+}
+
 export function createLocalEditor(kind: AgentWorkspaceLocalEditorKind | 'knowledge-url'): AgentWorkspaceLocalEditor {
   if (kind === 'profile') return createProfileEditor([]);
   if (kind === 'knowledge-url') {
@@ -53,7 +73,7 @@ export function createLocalEditor(kind: AgentWorkspaceLocalEditorKind | 'knowled
       mode: 'create',
       title: 'Create Memory',
       selectedFieldIndex: 0,
-      message: 'Record a durable, non-secret Agent memory. This stays in the Agent-owned memory store and never writes to default Knowledge/Wiki.',
+      message: 'Record a durable, non-secret Agent memory. This stays in the Agent-owned memory store and never writes to default knowledge.',
       fields: [
         { id: 'cls', label: 'Class', value: 'fact', required: true, multiline: false, hint: 'fact, decision, constraint, incident, pattern, risk, runbook, architecture, or ownership.' },
         { id: 'scope', label: 'Scope', value: 'project', required: true, multiline: false, hint: 'session, project, or team.' },
@@ -64,6 +84,21 @@ export function createLocalEditor(kind: AgentWorkspaceLocalEditorKind | 'knowled
       ],
     };
   }
+  if (kind === 'note') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Create Note',
+      selectedFieldIndex: 0,
+      message: 'Capture a local working note or source-triage note. Notes stay in the Agent-local scratchpad and are not memory or Agent Knowledge.',
+      fields: [
+        { id: 'title', label: 'Title', value: '', required: true, multiline: false, hint: 'Short note title.' },
+        { id: 'body', label: 'Note', value: '', required: true, multiline: true, hint: 'Working note, source triage, or temporary decision. Ctrl-J inserts a new line.' },
+        { id: 'sourceUrl', label: 'Source URL', value: '', required: false, multiline: false, hint: 'Optional reviewed URL. This does not ingest the URL into Agent Knowledge.' },
+        { id: 'tags', label: 'Tags', value: 'scratchpad', required: false, multiline: false, hint: 'Comma-separated optional tags.' },
+      ],
+    };
+  }
   if (kind === 'persona') {
     return {
       kind,
@@ -94,6 +129,8 @@ export function createLocalEditor(kind: AgentWorkspaceLocalEditorKind | 'knowled
         { id: 'procedure', label: 'Procedure', value: '', required: true, multiline: true, hint: 'Reusable steps. Ctrl-J inserts a new line.' },
         { id: 'triggers', label: 'Triggers', value: '', required: false, multiline: false, hint: 'Comma-separated words that suggest this skill.' },
         { id: 'tags', label: 'Tags', value: '', required: false, multiline: false, hint: 'Comma-separated optional tags.' },
+        { id: 'requiresEnv', label: 'Required env vars', value: '', required: false, multiline: false, hint: 'Comma-separated env var names. Values are never stored.' },
+        { id: 'requiresCommands', label: 'Required commands', value: '', required: false, multiline: false, hint: 'Comma-separated binaries that must be on PATH.' },
         { id: 'enabled', label: 'Enable now', value: 'yes', required: false, multiline: false, hint: 'yes/no.' },
       ],
     };
@@ -110,6 +147,8 @@ export function createLocalEditor(kind: AgentWorkspaceLocalEditorKind | 'knowled
       { id: 'steps', label: 'Steps', value: '', required: true, multiline: true, hint: 'Workflow steps. Ctrl-J inserts a new line.' },
       { id: 'triggers', label: 'Triggers', value: '', required: false, multiline: false, hint: 'Comma-separated words that suggest this routine.' },
       { id: 'tags', label: 'Tags', value: '', required: false, multiline: false, hint: 'Comma-separated optional tags.' },
+      { id: 'requiresEnv', label: 'Required env vars', value: '', required: false, multiline: false, hint: 'Comma-separated env var names. Values are never stored.' },
+      { id: 'requiresCommands', label: 'Required commands', value: '', required: false, multiline: false, hint: 'Comma-separated binaries that must be on PATH.' },
       { id: 'enabled', label: 'Enable now', value: 'yes', required: false, multiline: false, hint: 'yes/no.' },
     ],
   };
@@ -132,6 +171,127 @@ export function createMemoryUpdateEditor(record: MemoryRecord): AgentWorkspaceLo
   };
 }
 
+function noteDescription(note: AgentNoteRecord): string {
+  const compact = note.body.replace(/\s+/g, ' ').trim();
+  const firstSentence = compact.split(/(?<=[.!?])\s+/)[0]?.trim() ?? compact;
+  const base = firstSentence.length > 160 ? `${firstSentence.slice(0, 157)}...` : firstSentence;
+  return base || note.title;
+}
+
+function noteTags(note: AgentNoteRecord, extraTag: string): string {
+  return [...new Set([...note.tags, extraTag])].join(', ');
+}
+
+export function createMemoryEditorFromNote(note: AgentNoteRecord): AgentWorkspaceLocalEditor {
+  const sourceLine = note.sourceUrl ? `\n\nOrigin URL: ${note.sourceUrl}` : '';
+  return {
+    kind: 'memory',
+    mode: 'create',
+    title: 'Create Memory From Note',
+    selectedFieldIndex: 0,
+    message: `Promote ${note.title} into durable Agent memory. Saving writes memory only; the note remains in the scratchpad.`,
+    fields: [
+      { id: 'cls', label: 'Class', value: 'fact', required: true, multiline: false, hint: 'fact, decision, constraint, incident, pattern, risk, runbook, architecture, or ownership.' },
+      { id: 'scope', label: 'Scope', value: 'project', required: true, multiline: false, hint: 'session, project, or team.' },
+      { id: 'summary', label: 'Summary', value: note.title, required: true, multiline: false, hint: 'One durable sentence. Do not store secrets.' },
+      { id: 'detail', label: 'Detail', value: `${note.body}${sourceLine}`, required: false, multiline: true, hint: 'Optional supporting detail. Ctrl-J inserts a new line.' },
+      { id: 'tags', label: 'Tags', value: noteTags(note, 'from-note'), required: false, multiline: false, hint: 'Comma-separated optional tags.' },
+      { id: 'confidence', label: 'Confidence', value: note.reviewState === 'reviewed' ? '85' : '65', required: false, multiline: false, hint: '0-100 confidence score.' },
+    ],
+  };
+}
+
+export function createPersonaEditorFromNote(note: AgentNoteRecord): AgentWorkspaceLocalEditor {
+  return {
+    kind: 'persona',
+    mode: 'create',
+    title: 'Create Persona From Note',
+    selectedFieldIndex: 0,
+    message: `Use ${note.title} as the starting point for a local persona. Saving creates a persona only; the note remains in the scratchpad.`,
+    fields: [
+      { id: 'name', label: 'Name', value: note.title, required: true, multiline: false, hint: 'Short persona name.' },
+      { id: 'description', label: 'Description', value: noteDescription(note), required: true, multiline: false, hint: 'One-line summary of when to use it.' },
+      { id: 'body', label: 'Instructions', value: note.body, required: true, multiline: true, hint: 'Operating guidance. Ctrl-J inserts a new line.' },
+      { id: 'tags', label: 'Tags', value: noteTags(note, 'from-note'), required: false, multiline: false, hint: 'Comma-separated optional tags.' },
+      { id: 'triggers', label: 'Triggers', value: '', required: false, multiline: false, hint: 'Comma-separated words that suggest this persona.' },
+      { id: 'activate', label: 'Activate now', value: 'no', required: false, multiline: false, hint: 'yes/no.' },
+    ],
+  };
+}
+
+export function createSkillEditorFromNote(note: AgentNoteRecord): AgentWorkspaceLocalEditor {
+  return {
+    kind: 'skill',
+    mode: 'create',
+    title: 'Create Skill From Note',
+    selectedFieldIndex: 0,
+    message: `Use ${note.title} as the starting point for a reusable local skill. Saving creates a skill only; the note remains in the scratchpad.`,
+    fields: [
+      { id: 'name', label: 'Name', value: note.title, required: true, multiline: false, hint: 'Short skill name.' },
+      { id: 'description', label: 'Description', value: noteDescription(note), required: true, multiline: false, hint: 'One-line summary of the procedure.' },
+      { id: 'procedure', label: 'Procedure', value: note.body, required: true, multiline: true, hint: 'Reusable steps. Ctrl-J inserts a new line.' },
+      { id: 'triggers', label: 'Triggers', value: '', required: false, multiline: false, hint: 'Comma-separated words that suggest this skill.' },
+      { id: 'tags', label: 'Tags', value: noteTags(note, 'from-note'), required: false, multiline: false, hint: 'Comma-separated optional tags.' },
+      { id: 'requiresEnv', label: 'Required env vars', value: '', required: false, multiline: false, hint: 'Comma-separated env var names. Values are never stored.' },
+      { id: 'requiresCommands', label: 'Required commands', value: '', required: false, multiline: false, hint: 'Comma-separated binaries that must be on PATH.' },
+      { id: 'enabled', label: 'Enable now', value: 'yes', required: false, multiline: false, hint: 'yes/no.' },
+    ],
+  };
+}
+
+export function createRoutineEditorFromNote(note: AgentNoteRecord): AgentWorkspaceLocalEditor {
+  return {
+    kind: 'routine',
+    mode: 'create',
+    title: 'Create Routine From Note',
+    selectedFieldIndex: 0,
+    message: `Use ${note.title} as the starting point for a repeatable local routine. Saving creates a routine only; the note remains in the scratchpad.`,
+    fields: [
+      { id: 'name', label: 'Name', value: note.title, required: true, multiline: false, hint: 'Short routine name.' },
+      { id: 'description', label: 'Description', value: noteDescription(note), required: true, multiline: false, hint: 'One-line summary of the workflow.' },
+      { id: 'steps', label: 'Steps', value: note.body, required: true, multiline: true, hint: 'Workflow steps. Ctrl-J inserts a new line.' },
+      { id: 'triggers', label: 'Triggers', value: '', required: false, multiline: false, hint: 'Comma-separated words that suggest this routine.' },
+      { id: 'tags', label: 'Tags', value: noteTags(note, 'from-note'), required: false, multiline: false, hint: 'Comma-separated optional tags.' },
+      { id: 'requiresEnv', label: 'Required env vars', value: '', required: false, multiline: false, hint: 'Comma-separated env var names. Values are never stored.' },
+      { id: 'requiresCommands', label: 'Required commands', value: '', required: false, multiline: false, hint: 'Comma-separated binaries that must be on PATH.' },
+      { id: 'enabled', label: 'Enable now', value: 'yes', required: false, multiline: false, hint: 'yes/no.' },
+    ],
+  };
+}
+
+export function createKnowledgeUrlEditorFromNote(note: AgentNoteRecord): AgentWorkspaceLocalEditor {
+  return {
+    kind: 'knowledge-url',
+    mode: 'create',
+    title: 'Ingest Note Source Into Agent Knowledge',
+    selectedFieldIndex: 3,
+    message: `Review the source URL from ${note.title}, then type yes to ingest it into isolated Agent Knowledge. The scratchpad note remains unchanged.`,
+    fields: [
+      { id: 'url', label: 'URL', value: note.sourceUrl ?? '', required: true, multiline: false, hint: 'HTTP or HTTPS URL to ingest into Agent Knowledge only.' },
+      { id: 'tags', label: 'Tags', value: noteTags(note, 'from-note'), required: false, multiline: false, hint: 'Comma-separated optional tags. Spaces are not needed.' },
+      { id: 'folder', label: 'Folder', value: 'notes', required: false, multiline: false, hint: 'Optional Agent Knowledge folder path.' },
+      { id: 'confirm', label: 'Confirm', value: '', required: true, multiline: false, hint: 'Type yes to run /knowledge ingest-url with --yes.' },
+    ],
+  };
+}
+
+export function createNoteUpdateEditor(record: AgentNoteRecord): AgentWorkspaceLocalEditor {
+  return {
+    kind: 'note',
+    mode: 'update',
+    recordId: record.id,
+    title: 'Edit Note',
+    selectedFieldIndex: 0,
+    message: `Editing ${record.title}. Saving keeps it in the Agent-local scratchpad only.`,
+    fields: [
+      { id: 'title', label: 'Title', value: record.title, required: true, multiline: false, hint: 'Short note title.' },
+      { id: 'body', label: 'Note', value: record.body, required: true, multiline: true, hint: 'Working note, source triage, or temporary decision. Ctrl-J inserts a new line.' },
+      { id: 'sourceUrl', label: 'Source URL', value: record.sourceUrl ?? '', required: false, multiline: false, hint: 'Optional reviewed URL. This does not ingest the URL into Agent Knowledge.' },
+      { id: 'tags', label: 'Tags', value: record.tags.join(', '), required: false, multiline: false, hint: 'Comma-separated optional tags.' },
+    ],
+  };
+}
+
 export function createPersonaUpdateEditor(record: AgentPersonaRecord, active: boolean): AgentWorkspaceLocalEditor {
   return {
     kind: 'persona',
@@ -165,6 +325,8 @@ export function createSkillUpdateEditor(record: AgentSkillRecord): AgentWorkspac
       { id: 'procedure', label: 'Procedure', value: record.procedure, required: true, multiline: true, hint: 'Reusable steps. Ctrl-J inserts a new line.' },
       { id: 'triggers', label: 'Triggers', value: record.triggers.join(', '), required: false, multiline: false, hint: 'Comma-separated words that suggest this skill.' },
       { id: 'tags', label: 'Tags', value: record.tags.join(', '), required: false, multiline: false, hint: 'Comma-separated optional tags.' },
+      { id: 'requiresEnv', label: 'Required env vars', value: record.requirements.filter((requirement) => requirement.kind === 'env').map((requirement) => requirement.name).join(', '), required: false, multiline: false, hint: 'Comma-separated env var names. Values are never stored.' },
+      { id: 'requiresCommands', label: 'Required commands', value: record.requirements.filter((requirement) => requirement.kind === 'command').map((requirement) => requirement.name).join(', '), required: false, multiline: false, hint: 'Comma-separated binaries that must be on PATH.' },
       { id: 'enabled', label: 'Enabled', value: record.enabled ? 'yes' : 'no', required: false, multiline: false, hint: 'yes/no.' },
     ],
   };
@@ -184,6 +346,8 @@ export function createRoutineUpdateEditor(record: AgentRoutineRecord): AgentWork
       { id: 'steps', label: 'Steps', value: record.steps, required: true, multiline: true, hint: 'Workflow steps. Ctrl-J inserts a new line.' },
       { id: 'triggers', label: 'Triggers', value: record.triggers.join(', '), required: false, multiline: false, hint: 'Comma-separated words that suggest this routine.' },
       { id: 'tags', label: 'Tags', value: record.tags.join(', '), required: false, multiline: false, hint: 'Comma-separated optional tags.' },
+      { id: 'requiresEnv', label: 'Required env vars', value: record.requirements.filter((requirement) => requirement.kind === 'env').map((requirement) => requirement.name).join(', '), required: false, multiline: false, hint: 'Comma-separated env var names. Values are never stored.' },
+      { id: 'requiresCommands', label: 'Required commands', value: record.requirements.filter((requirement) => requirement.kind === 'command').map((requirement) => requirement.name).join(', '), required: false, multiline: false, hint: 'Comma-separated binaries that must be on PATH.' },
       { id: 'enabled', label: 'Enabled', value: record.enabled ? 'yes' : 'no', required: false, multiline: false, hint: 'yes/no.' },
     ],
   };
@@ -215,6 +379,7 @@ export function isAffirmative(value: string): boolean {
 
 export function editorCategoryId(kind: AgentWorkspaceLocalEditorKind): string {
   if (kind === 'memory') return 'memory';
+  if (kind === 'note') return 'notes';
   if (kind === 'profile') return 'profiles';
   if (kind === 'persona') return 'personas';
   if (kind === 'skill') return 'skills';