@pellux/goodvibes-agent 0.1.117 → 1.0.0

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

@@ -27,6 +27,40 @@ 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'

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

@@ -2,14 +2,32 @@ import type { AgentWorkspaceEditorKind, AgentWorkspaceLocalEditor } from './agen
 
 export type AgentWorkspaceChannelCommandEditorKind = Extract<
   AgentWorkspaceEditorKind,
-  'channel-show' | 'channel-doctor' | 'channel-setup'
+  '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';
+  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,
@@ -18,7 +36,7 @@ export function createAgentWorkspaceChannelCommandEditor(kind: AgentWorkspaceCha
       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, or whatsapp.' },
+        { id: 'channel', label: 'Channel id', value: '', required: true, multiline: false, hint: 'Channel id, such as slack, telegram, discord, ntfy, signal, whatsapp, or telephony.' },
       ],
     };
   }
@@ -30,7 +48,7 @@ export function createAgentWorkspaceChannelCommandEditor(kind: AgentWorkspaceCha
       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, or whatsapp.' },
+        { id: 'channel', label: 'Channel id', value: '', required: true, multiline: false, hint: 'Channel id, such as slack, telegram, discord, ntfy, signal, whatsapp, or telephony.' },
       ],
     };
   }
@@ -41,7 +59,7 @@ export function createAgentWorkspaceChannelCommandEditor(kind: AgentWorkspaceCha
     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, or whatsapp.' },
+      { 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

@@ -4,12 +4,15 @@ import { buildAgentKnowledgeUrlEditorSubmission } from './agent-workspace-knowle
 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 = AgentWorkspaceBasicCommandEditorKind | Extract<
   AgentWorkspaceEditorKind,
-  'knowledge-url'
+  'web-research'
+  | 'web-fetch'
+  | 'knowledge-url'
   | 'knowledge-urls'
   | 'knowledge-file'
   | 'knowledge-browser-history'
@@ -22,6 +25,7 @@ type AgentWorkspaceCommandEditorKind = AgentWorkspaceBasicCommandEditorKind | Ex
   | 'notify-webhook-remove'
   | 'notify-webhook-clear'
   | 'notify-webhook-test'
+  | 'notify-send'
   | 'secret-set'
   | 'secret-link'
   | 'secret-test'
@@ -67,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'
@@ -82,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

@@ -37,7 +37,7 @@ export function buildAgentWorkspaceDelegationEditorSubmission(
     };
   }
   const parts = ['/delegate'];
-  if (isAffirmative(readField('wrfc'))) parts.push('--wrfc');
+  if (isAffirmative(readField('review')) || isAffirmative(readField('wrfc'))) parts.push('--review');
   parts.push(quoteSlashCommandArg(readField('task')));
   const command = parts.join(' ');
   return {

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,
@@ -36,7 +37,7 @@ export function createLearnedBehaviorEditor(): AgentWorkspaceLocalEditor {
     mode: 'create',
     title: 'Capture Learned Behavior',
     selectedFieldIndex: 0,
-    message: 'Turn a reviewed workflow or lesson into local Agent behavior. This writes only to local personas, skills, or routines.',
+    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.' },
@@ -72,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.' },
@@ -83,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,
@@ -155,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',
@@ -242,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';

package/src/input/agent-workspace-knowledge-query-editor.ts

@@ -25,7 +25,7 @@ export function createAgentKnowledgeQueryEditor(mode: AgentKnowledgeQueryMode):
     title: mode === 'ask' ? 'Ask Agent Knowledge' : 'Search Agent Knowledge',
     selectedFieldIndex: 0,
     message: mode === 'ask'
-      ? 'Ask the isolated Agent Knowledge segment. If it has no answer, it fails closed instead of using another wiki.'
+      ? 'Ask the isolated Agent Knowledge segment. If it has no answer, it fails closed instead of using another knowledge segment.'
       : 'Search the isolated Agent Knowledge segment. Results come from Agent-owned sources only.',
     fields: [
       {

package/src/input/agent-workspace-learned-behavior.ts

@@ -5,7 +5,7 @@ import { AgentSkillRegistry } from '../agent/skill-registry.ts';
 import type { AgentWorkspaceLocalEditorKind } from './agent-workspace-types.ts';
 
 export interface AgentWorkspaceLearnedBehaviorInput {
-  readonly target: Exclude<AgentWorkspaceLocalEditorKind, 'memory' | 'profile'>;
+  readonly target: Exclude<AgentWorkspaceLocalEditorKind, 'memory' | 'note' | 'profile'>;
   readonly name: string;
   readonly description: string;
   readonly notes: string;
@@ -15,7 +15,7 @@ export interface AgentWorkspaceLearnedBehaviorInput {
 }
 
 export interface AgentWorkspaceLearnedBehaviorResult {
-  readonly kind: Exclude<AgentWorkspaceLocalEditorKind, 'memory' | 'profile'>;
+  readonly kind: Exclude<AgentWorkspaceLocalEditorKind, 'memory' | 'note' | 'profile'>;
   readonly id: string;
   readonly name: string;
 }

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

@@ -28,7 +28,7 @@ export function buildAgentWorkspaceLibraryCommandEditorSubmission(
   readField: AgentWorkspaceFieldReader,
 ): AgentWorkspaceLibraryCommandEditorSubmission {
   const target = editor.kind.startsWith('persona') ? 'persona' : editor.kind.startsWith('skill') ? 'skill' : 'routine';
-  const root = target === 'persona' ? '/personas' : target === 'skill' ? '/agent-skills' : '/routines';
+  const root = target === 'persona' ? '/personas' : target === 'skill' ? '/skills' : '/routines';
   const search = editor.kind.endsWith('search');
   const command = search
     ? `${root} search ${quoteSlashCommandArg(readField('query'))}`

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

@@ -24,8 +24,8 @@ export function createAgentWorkspaceLibraryCommandEditor(kind: AgentWorkspaceLib
     title: search ? `Search ${label}s` : `Show ${label}`,
     selectedFieldIndex: 0,
     message: search
-      ? `Search local Agent ${target}s by name, description, tags, triggers, or body.`
-      : `Show one local Agent ${target} by id.`,
+      ? `Search Agent-local ${target}s by name, description, tags, triggers, or body.`
+      : `Show one Agent-local ${target} by id.`,
     fields: [
       search
         ? { id: 'query', label: 'Search query', value: '', required: false, multiline: false, hint: `Optional text query. Blank lists every local ${target}.` }