ticlawk 0.1.16-dev.2 → 0.1.16-dev.20

package/README.md

@@ -216,8 +216,12 @@ Agent CLI (run inside an agent runtime; requires TICLAWK_RUNTIME_AGENT_ID):
   ticlawk message read --target <t> [opts]
   ticlawk task claim --message-id <id>
   ticlawk task update --task-id <id> --status <s>
-  ticlawk task list [--target <t>]
+  ticlawk task list [--target <t>]       # group admins see the full task board
+  ticlawk charter get --target <t>
   ticlawk group members --target <t>
+  ticlawk group list
+  ticlawk agent list
+  ticlawk dashboard get --conversation-id <id>
   ticlawk server info [--refresh]
 
 Commands:
@@ -226,7 +230,15 @@ Commands:
   profile  list or switch saved local identities
   message  send/read chat messages (agent CLI surface)
   task     claim/update/list tasks (agent CLI surface)
-  group    list members of a group conversation (agent CLI surface)
+  charter  get/set conversation goal and role spec (agent CLI surface)
+  group    create/list/delete groups, manage charters/members (agent CLI surface)
+  dashboard   set/get conversation dashboards (agent CLI surface)
+  briefing    publish/get owner briefings (agent CLI surface)
+  agent       list/create/delete owned agent slots (agent CLI surface)
+  service     publish/list/call shared services (agent CLI surface)
+  credential  request owner-filled credentials (agent CLI surface)
+  reminder    schedule/list/snooze/cancel reminders (agent CLI surface)
+  attachment  view private chat assets (agent CLI surface)
   server   server-info introspection (agent CLI surface)
   install-daemon  install or refresh the background daemon
   update   update the npm package and refresh the daemon

package/bin/ticlawk.mjs

@@ -30,9 +30,27 @@ import { getInstallDaemonHelp, runInstallDaemon } from '../src/core/daemon-insta
 import { runSetupReadiness } from '../src/core/setup-readiness.mjs';
 import {
   AGENT_COMMAND_HELP,
-  runAttachmentUploadCommand,
   runAttachmentViewCommand,
   runGroupCreateCommand,
+  runWorkstreamCharterGetCommand,
+  runWorkstreamCharterSetCommand,
+  runWorkstreamCreateCommand,
+  runWorkstreamDeleteCommand,
+  runWorkstreamListCommand,
+  runAgentListCommand,
+  runAgentCreateCommand,
+  runAgentDeleteCommand,
+  runDashboardSetCommand,
+  runDashboardGetCommand,
+  runCredentialRequestCommand,
+  runBriefingPublishCommand,
+  runBriefingGetCommand,
+  runServiceCreateCommand,
+  runServiceUpdateCommand,
+  runServiceDeleteCommand,
+  runServiceListCommand,
+  runServiceInfoCommand,
+  runServiceCallCommand,
   runGroupMembersAddCommand,
   runGroupMembersCommand,
   runGroupMembersRemoveCommand,
@@ -97,8 +115,12 @@ Agent CLI (run inside an agent runtime; requires TICLAWK_RUNTIME_AGENT_ID):
   ticlawk message read --target <t> [opts]
   ticlawk task claim --message-id <id>
   ticlawk task update --task-id <id> --status <s>
-  ticlawk task list [--target <t>]
+  ticlawk task list [--target <t>]       # group admins see the full task board
+  ticlawk charter get --target <t>
   ticlawk group members --target <t>
+  ticlawk group list
+  ticlawk agent list
+  ticlawk dashboard get --conversation-id <id>
   ticlawk server info [--refresh]
 
 Commands:
@@ -107,7 +129,15 @@ Commands:
   profile  list or switch saved local identities
   message  send/read chat messages (agent CLI surface)
   task     claim/update/list tasks (agent CLI surface)
-  group    list members of a group conversation (agent CLI surface)
+  charter  get/set conversation goal and role spec (agent CLI surface)
+  group    create/list/delete groups, manage charters/members (agent CLI surface)
+  dashboard   set/get conversation dashboards (agent CLI surface)
+  briefing    publish/get owner briefings (agent CLI surface)
+  agent       list/create/delete owned agent slots (agent CLI surface)
+  service     publish/list/call shared services (agent CLI surface)
+  credential  request owner-filled credentials (agent CLI surface)
+  reminder    schedule/list/snooze/cancel reminders (agent CLI surface)
+  attachment  view private chat assets (agent CLI surface)
   server   server-info introspection (agent CLI surface)
   install-daemon  install or refresh the background daemon
   update   update the npm package and refresh the daemon
@@ -179,6 +209,10 @@ function printHelp(helpPath, args = {}) {
     console.log(getInstallDaemonHelp());
     return;
   }
+  if (AGENT_COMMAND_HELP[head]) {
+    console.log(AGENT_COMMAND_HELP[head]);
+    return;
+  }
   printUsage();
 }
 
@@ -358,24 +392,6 @@ async function main() {
     process.exit(1);
   }
 
-  if (command === 'profile') {
-    const sub = args._[1];
-    if (args.help || args.h || !sub) {
-      console.log(AGENT_COMMAND_HELP.profile);
-      return;
-    }
-    if (sub === 'show') {
-      process.exitCode = await runProfileShowCommand(args);
-      return;
-    }
-    if (sub === 'update') {
-      process.exitCode = await runProfileUpdateCommand(args);
-      return;
-    }
-    console.error(`unknown profile subcommand: ${sub}`);
-    process.exit(1);
-  }
-
   if (command === 'reminder') {
     const sub = args._[1];
     if (args.help || args.h || !sub) {
@@ -416,10 +432,6 @@ async function main() {
       console.log(AGENT_COMMAND_HELP.attachment);
       return;
     }
-    if (sub === 'upload') {
-      process.exitCode = await runAttachmentUploadCommand(args);
-      return;
-    }
     if (sub === 'view') {
       process.exitCode = await runAttachmentViewCommand(args);
       return;
@@ -458,6 +470,147 @@ async function main() {
     process.exit(1);
   }
 
+  if (command === 'workstream') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.workstream);
+      return;
+    }
+    if (sub === 'create') {
+      process.exitCode = await runWorkstreamCreateCommand(args);
+      return;
+    }
+    if (sub === 'delete') {
+      process.exitCode = await runWorkstreamDeleteCommand(args);
+      return;
+    }
+    if (sub === 'list') {
+      process.exitCode = await runWorkstreamListCommand(args);
+      return;
+    }
+    if (sub === 'charter') {
+      const op = args._[2];
+      if (op === 'get') {
+        process.exitCode = await runWorkstreamCharterGetCommand(args);
+        return;
+      }
+      if (op === 'set') {
+        process.exitCode = await runWorkstreamCharterSetCommand(args);
+        return;
+      }
+      console.error(`unknown workstream charter op: ${op}`);
+      process.exit(1);
+    }
+    console.error(`unknown workstream subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'agent') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.agent);
+      return;
+    }
+    if (sub === 'list') {
+      process.exitCode = await runAgentListCommand(args);
+      return;
+    }
+    if (sub === 'create') {
+      process.exitCode = await runAgentCreateCommand(args);
+      return;
+    }
+    if (sub === 'delete') {
+      process.exitCode = await runAgentDeleteCommand(args);
+      return;
+    }
+    console.error(`unknown agent subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'service') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.service);
+      return;
+    }
+    if (sub === 'create') { process.exitCode = await runServiceCreateCommand(args); return; }
+    if (sub === 'update') { process.exitCode = await runServiceUpdateCommand(args); return; }
+    if (sub === 'delete') { process.exitCode = await runServiceDeleteCommand(args); return; }
+    if (sub === 'list')   { process.exitCode = await runServiceListCommand(args); return; }
+    if (sub === 'info')   { process.exitCode = await runServiceInfoCommand(args); return; }
+    if (sub === 'call')   { process.exitCode = await runServiceCallCommand(args); return; }
+    console.error(`unknown service subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'briefing') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.briefing);
+      return;
+    }
+    if (sub === 'publish') {
+      process.exitCode = await runBriefingPublishCommand(args);
+      return;
+    }
+    if (sub === 'get') {
+      process.exitCode = await runBriefingGetCommand(args);
+      return;
+    }
+    console.error(`unknown briefing subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'credential') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.credential);
+      return;
+    }
+    if (sub === 'request') {
+      process.exitCode = await runCredentialRequestCommand(args);
+      return;
+    }
+    console.error(`unknown credential subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'dashboard') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.dashboard);
+      return;
+    }
+    if (sub === 'set') {
+      process.exitCode = await runDashboardSetCommand(args);
+      return;
+    }
+    if (sub === 'get') {
+      process.exitCode = await runDashboardGetCommand(args);
+      return;
+    }
+    console.error(`unknown dashboard subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'charter') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.charter);
+      return;
+    }
+    if (sub === 'get') {
+      process.exitCode = await runWorkstreamCharterGetCommand(args);
+      return;
+    }
+    if (sub === 'set') {
+      process.exitCode = await runWorkstreamCharterSetCommand(args);
+      return;
+    }
+    console.error(`unknown charter subcommand: ${sub}`);
+    process.exit(1);
+  }
+
   if (command === 'group') {
     const sub = args._[1];
     if (args.help || args.h || !sub) {
@@ -468,6 +621,27 @@ async function main() {
       process.exitCode = await runGroupCreateCommand(args);
       return;
     }
+    if (sub === 'list') {
+      process.exitCode = await runWorkstreamListCommand(args);
+      return;
+    }
+    if (sub === 'delete') {
+      process.exitCode = await runWorkstreamDeleteCommand(args);
+      return;
+    }
+    if (sub === 'charter') {
+      const op = args._[2];
+      if (op === 'get') {
+        process.exitCode = await runWorkstreamCharterGetCommand(args);
+        return;
+      }
+      if (op === 'set') {
+        process.exitCode = await runWorkstreamCharterSetCommand(args);
+        return;
+      }
+      console.error(`unknown group charter op: ${op}`);
+      process.exit(1);
+    }
     if (sub === 'members') {
       // Same subcommand handles list / add / remove based on flags.
       if (args.add) {
@@ -610,6 +784,14 @@ async function main() {
       console.log('Restart ticlawk for the daemon to use the selected profile.');
       return;
     }
+    if (subcommand === 'show') {
+      process.exitCode = await runProfileShowCommand(args);
+      return;
+    }
+    if (subcommand === 'update') {
+      process.exitCode = await runProfileUpdateCommand(args);
+      return;
+    }
     console.error(`unknown profile subcommand: ${subcommand}`);
     process.exit(1);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticlawk",
-  "version": "0.1.16-dev.2",
+  "version": "0.1.16-dev.20",
   "description": "Local connector that links agent harnesses (Claude Code, Codex, OpenClaw, opencode, Pi) to the Ticlawk mobile app.",
   "type": "module",
   "main": "ticlawk.mjs",

package/src/adapters/ticlawk/api.mjs

@@ -149,18 +149,6 @@ export async function updateChannel(id, updates) {
   return updateAgent(id, updates);
 }
 
-export async function postRuntimeResult(body) {
-  // Activity-only: backend records the agent_event for UI trajectory
-  // display but does NOT project it into a chat message. The agent CLI's
-  // `ticlawk message send` is the only path that produces chat rows.
-  const result = await apiFetch('/api/runtime-results', {
-    method: 'POST',
-    body: JSON.stringify(body),
-    timeout: 30000,
-  });
-  return result;
-}
-
 // ── Deliveries (replaces legacy message_jobs poll/ack) ──
 
 export async function claimPendingDeliveries(hostId, limit = 5, excludedAgentIds = []) {
@@ -199,6 +187,8 @@ export async function sendAgentMessage({
   replyToMessageId,
   runtimeHostId,
   visibility,
+  mediaAssetIds,
+  metadata,
 }) {
   const { data } = await apiFetch('/api/agent/messages/send', {
     method: 'POST',
@@ -210,6 +200,8 @@ export async function sendAgentMessage({
       reply_to_message_id: replyToMessageId ?? null,
       runtime_host_id: runtimeHostId ?? null,
       visibility: visibility || null,
+      media_asset_ids: Array.isArray(mediaAssetIds) && mediaAssetIds.length > 0 ? mediaAssetIds : undefined,
+      metadata: metadata ?? undefined,
     }),
   });
   return data || null;
@@ -436,6 +428,20 @@ export async function uploadAgentAttachment({
   });
 }
 
+export async function uploadAgentAvatar({
+  actingAgentId, filename, contentType, dataBase64,
+}) {
+  return apiFetch('/api/agent/profile/avatar', {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      filename,
+      content_type: contentType,
+      data_base64: dataBase64,
+    }),
+  });
+}
+
 export async function viewAgentAttachment({ actingAgentId, assetId }) {
   const params = new URLSearchParams();
   params.set('acting_as_agent_id', actingAgentId);
@@ -480,20 +486,222 @@ export async function removeAgentGroupMember({
   );
 }
 
-// ── Upload ──
+// ── Workstreams (managed groups) ──
 
-export async function uploadAsset(fileName, fileData, contentType, kind = 'chat_media') {
-  const formData = new FormData();
-  formData.append('file', new Blob([fileData], { type: contentType }), fileName);
-  formData.append('kind', kind);
-  if (contentType) formData.append('content_type', contentType);
+export async function createWorkstream({
+  actingAgentId, name, description, charter, memberAgentIds,
+}) {
+  return apiFetch('/api/agent/workstreams', {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      name,
+      description: description ?? null,
+      charter: charter ?? null,
+      member_agent_ids: memberAgentIds || [],
+    }),
+  });
+}
 
-  const { data } = await apiFetch('/api/assets/upload', {
+export async function deleteWorkstream({ actingAgentId, conversationId }) {
+  return apiFetch(
+    `/api/agent/workstreams/${encodeURIComponent(conversationId)}`,
+    {
+      method: 'DELETE',
+      body: JSON.stringify({ acting_as_agent_id: actingAgentId }),
+    },
+  );
+}
+
+export async function listWorkstreams({ actingAgentId }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  const { data } = await apiFetch(`/api/agent/workstreams?${params}`);
+  return data || [];
+}
+
+// ── Agents ──
+
+export async function listAgentSlots({ actingAgentId }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  const { data } = await apiFetch(`/api/agent/agents?${params}`);
+  return data || [];
+}
+
+export async function createAgentSlot({
+  actingAgentId, name, runtime, description, displayName, model,
+}) {
+  return apiFetch('/api/agent/agents', {
     method: 'POST',
-    body: formData,
-    timeout: 30000,
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      name,
+      runtime,
+      description: description ?? null,
+      display_name: displayName ?? null,
+      model: model ?? null,
+    }),
   });
-  return data;
+}
+
+export async function archiveAgentSlot({ actingAgentId, agentId }) {
+  return apiFetch(
+    `/api/agent/agents/${encodeURIComponent(agentId)}`,
+    {
+      method: 'DELETE',
+      body: JSON.stringify({ acting_as_agent_id: actingAgentId }),
+    },
+  );
+}
+
+// ── Services ──
+
+export async function createService({
+  actingAgentId, name, description, contractSchema, endpointConfig,
+}) {
+  return apiFetch('/api/agent/services', {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      name,
+      description: description ?? null,
+      contract_schema: contractSchema ?? null,
+      endpoint_config: endpointConfig,
+    }),
+  });
+}
+
+export async function updateService({ actingAgentId, serviceId, ...patch }) {
+  return apiFetch(
+    `/api/agent/services/${encodeURIComponent(serviceId)}`,
+    {
+      method: 'PATCH',
+      body: JSON.stringify({ acting_as_agent_id: actingAgentId, ...patch }),
+    },
+  );
+}
+
+export async function deleteService({ actingAgentId, serviceId }) {
+  return apiFetch(
+    `/api/agent/services/${encodeURIComponent(serviceId)}`,
+    {
+      method: 'DELETE',
+      body: JSON.stringify({ acting_as_agent_id: actingAgentId }),
+    },
+  );
+}
+
+export async function listServices({ actingAgentId }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  const { data } = await apiFetch(`/api/agent/services?${params}`);
+  return data || [];
+}
+
+export async function getServiceInfo({ actingAgentId, name }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  return apiFetch(
+    `/api/agent/services/${encodeURIComponent(name)}/info?${params}`,
+  );
+}
+
+export async function callService({ actingAgentId, name, input }) {
+  return apiFetch(
+    `/api/agent/services/${encodeURIComponent(name)}/call`,
+    {
+      method: 'POST',
+      body: JSON.stringify({ acting_as_agent_id: actingAgentId, input }),
+    },
+  );
+}
+
+// ── Briefings ──
+
+export async function getBriefing({actingAgentId, briefingId}) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  return apiFetch(`/api/agent/briefings/${encodeURIComponent(briefingId)}?${params}`);
+}
+
+export async function publishBriefing({actingAgentId, bodyText, attachmentAssetId, currentConversationId, responseMode}) {
+  const body = { acting_as_agent_id: actingAgentId };
+  if (bodyText != null) body.body_text = bodyText;
+  if (attachmentAssetId != null) body.attachment_asset_id = attachmentAssetId;
+  if (currentConversationId != null) body.current_conversation_id = currentConversationId;
+  if (responseMode != null) body.response_mode = responseMode;
+  return apiFetch('/api/agent/briefings', {
+    method: 'POST',
+    body: JSON.stringify(body),
+  });
+}
+
+// ── Credentials (slot creation + daemon sync) ──
+
+export async function fetchCredentials() {
+  return apiFetch('/api/agent/credentials', { method: 'GET' });
+}
+
+export async function requestCredential({
+  actingAgentId, name, description, workstreamId,
+}) {
+  return apiFetch('/api/agent/credentials', {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      name,
+      description: description ?? null,
+      workstream_id: workstreamId ?? null,
+    }),
+  });
+}
+
+// ── Workstream dashboard ──
+
+export async function setWorkstreamDashboard({
+  actingAgentId, conversationId, dataJson, htmlTemplate,
+}) {
+  const body = { acting_as_agent_id: actingAgentId };
+  // Distinguish "omit" from "set to null" — only include keys the caller
+  // explicitly passed (including null clears the field).
+  if (dataJson !== undefined) body.data_json = dataJson;
+  if (htmlTemplate !== undefined) body.html_template = htmlTemplate;
+  return apiFetch(
+    `/api/agent/workstreams/${encodeURIComponent(conversationId)}/dashboard`,
+    { method: 'POST', body: JSON.stringify(body) },
+  );
+}
+
+export async function getWorkstreamDashboard({ actingAgentId, conversationId }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  return apiFetch(
+    `/api/agent/workstreams/${encodeURIComponent(conversationId)}/dashboard?${params}`,
+  );
+}
+
+// ── Workstream charter ──
+
+export async function getWorkstreamCharter({ actingAgentId, conversationId }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  return apiFetch(
+    `/api/agent/workstreams/${encodeURIComponent(conversationId)}/charter?${params}`,
+  );
+}
+
+export async function setWorkstreamCharter({ actingAgentId, conversationId, charter }) {
+  return apiFetch(
+    `/api/agent/workstreams/${encodeURIComponent(conversationId)}/charter`,
+    {
+      method: 'POST',
+      body: JSON.stringify({
+        acting_as_agent_id: actingAgentId,
+        charter: charter ?? null,
+      }),
+    },
+  );
 }
 
 // ── Channel event pipe ──

package/src/adapters/ticlawk/credentials.mjs

@@ -6,7 +6,20 @@
  * using the connector-specific env name.
  */
 
-import { AF_CONFIG_PATH, persistConfig, TICLAWK_CONNECTOR_API_KEY } from '../../core/config.mjs';
+import { AF_CONFIG_PATH, loadPersistentConfig, persistConfig, TICLAWK_CONNECTOR_API_KEY } from '../../core/config.mjs';
+
+export const TICLAWK_CREDENTIAL_NAMES = 'TICLAWK_CREDENTIAL_NAMES';
+
+function isRuntimeCredentialName(value) {
+  return /^[A-Z][A-Z0-9_]*$/.test(String(value || '').trim());
+}
+
+function parseCredentialNames(value) {
+  return String(value || '')
+    .split(',')
+    .map((name) => name.trim())
+    .filter(isRuntimeCredentialName);
+}
 
 export function persistApiCredential(apiKey) {
   if (!apiKey || !apiKey.startsWith('tk_')) return;
@@ -19,3 +32,30 @@ export function persistApiCredential(apiKey) {
   delete process.env.TICLAWK_SETUP_CODE;
   console.log(`[connect] saved ${TICLAWK_CONNECTOR_API_KEY} to ${AF_CONFIG_PATH}`);
 }
+
+export function persistRuntimeCredentials(credentials = []) {
+  const current = loadPersistentConfig();
+  const previousNames = new Set(parseCredentialNames(current[TICLAWK_CREDENTIAL_NAMES]));
+  const nextNames = [];
+  const updates = {};
+
+  for (const credential of Array.isArray(credentials) ? credentials : []) {
+    const name = String(credential?.name || '').trim();
+    const value = typeof credential?.value === 'string' ? credential.value : '';
+    if (!isRuntimeCredentialName(name) || !value) continue;
+    updates[name] = value;
+    nextNames.push(name);
+  }
+
+  const nextNameSet = new Set(nextNames);
+  for (const name of previousNames) {
+    if (!nextNameSet.has(name)) updates[name] = '';
+  }
+  updates[TICLAWK_CREDENTIAL_NAMES] = nextNames.join(',');
+
+  persistConfig(updates);
+  return {
+    saved: nextNames.length,
+    removed: [...previousNames].filter((name) => !nextNameSet.has(name)).length,
+  };
+}