ticlawk 0.1.16-dev.14 → 0.1.16-dev.16

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

@@ -37,12 +37,14 @@ import {
   runWorkstreamCreateCommand,
   runWorkstreamDeleteCommand,
   runWorkstreamListCommand,
+  runAgentListCommand,
   runAgentCreateCommand,
   runAgentDeleteCommand,
   runDashboardSetCommand,
   runDashboardGetCommand,
   runCredentialRequestCommand,
   runBriefingPublishCommand,
+  runBriefingGetCommand,
   runServiceCreateCommand,
   runServiceUpdateCommand,
   runServiceDeleteCommand,
@@ -113,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:
@@ -123,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
@@ -195,6 +209,10 @@ function printHelp(helpPath, args = {}) {
     console.log(getInstallDaemonHelp());
     return;
   }
+  if (AGENT_COMMAND_HELP[head]) {
+    console.log(AGENT_COMMAND_HELP[head]);
+    return;
+  }
   printUsage();
 }
 
@@ -374,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) {
@@ -511,6 +511,10 @@ async function main() {
       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;
@@ -549,6 +553,10 @@ async function main() {
       process.exitCode = await runBriefingPublishCommand(args);
       return;
     }
+    if (sub === 'get') {
+      process.exitCode = await runBriefingGetCommand(args);
+      return;
+    }
     console.error(`unknown briefing subcommand: ${sub}`);
     process.exit(1);
   }
@@ -585,6 +593,24 @@ async function main() {
     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) {
@@ -595,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) {
@@ -737,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.14",
+  "version": "0.1.16-dev.16",
   "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

@@ -486,7 +486,7 @@ export async function removeAgentGroupMember({
   );
 }
 
-// ── Workstreams (CoS-managed groups) ──
+// ── Workstreams (managed groups) ──
 
 export async function createWorkstream({
   actingAgentId, name, description, charter, memberAgentIds,
@@ -520,7 +520,14 @@ export async function listWorkstreams({ actingAgentId }) {
   return data || [];
 }
 
-// ── Agents (CoS pre-allocation) ──
+// ── 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,
@@ -610,19 +617,30 @@ export async function callService({ actingAgentId, name, input }) {
   );
 }
 
-// ── Briefings (CoS publish) ──
+// ── Briefings ──
 
-export async function publishBriefing({actingAgentId, bodyText, bodyHtml}) {
+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}) {
   const body = { acting_as_agent_id: actingAgentId };
   if (bodyText != null) body.body_text = bodyText;
-  if (bodyHtml != null) body.body_html = bodyHtml;
+  if (attachmentAssetId != null) body.attachment_asset_id = attachmentAssetId;
+  if (currentConversationId != null) body.current_conversation_id = currentConversationId;
   return apiFetch('/api/agent/briefings', {
     method: 'POST',
     body: JSON.stringify(body),
   });
 }
 
-// ── Credentials (CoS slot creation) ──
+// ── Credentials (slot creation + daemon sync) ──
+
+export async function fetchCredentials() {
+  return apiFetch('/api/agent/credentials', { method: 'GET' });
+}
 
 export async function requestCredential({
   actingAgentId, name, description, workstreamId,

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,
+  };
+}