ticlawk 0.1.16-dev.14 → 0.1.16-dev.15

package/bin/ticlawk.mjs

@@ -43,6 +43,7 @@ import {
   runDashboardGetCommand,
   runCredentialRequestCommand,
   runBriefingPublishCommand,
+  runBriefingGetCommand,
   runServiceCreateCommand,
   runServiceUpdateCommand,
   runServiceDeleteCommand,
@@ -549,6 +550,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);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticlawk",
-  "version": "0.1.16-dev.14",
+  "version": "0.1.16-dev.15",
   "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

@@ -612,6 +612,12 @@ export async function callService({ actingAgentId, name, input }) {
 
 // ── Briefings (CoS publish) ──
 
+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, bodyHtml}) {
   const body = { acting_as_agent_id: actingAgentId };
   if (bodyText != null) body.body_text = bodyText;

package/src/adapters/ticlawk/index.mjs

@@ -180,12 +180,39 @@ function buildCosAddendum(msg) {
   return COS_ADDENDUM;
 }
 
+// Quote block: surfaced just above the user's reply so the agent sees
+// what artifact the reply is *about*. Source of truth is
+// `messages.metadata.quote = { kind, ref, snippet }`. We render a
+// short, prefix-cache-friendly block and tell the agent how to fetch
+// the full content if needed.
+function buildQuoteBlock(msg) {
+  const meta = msg.message_metadata || msg.metadata || null;
+  const quote = meta && typeof meta === 'object' ? meta.quote : null;
+  if (!quote || typeof quote !== 'object') return '';
+  const kind = String(quote.kind || '').trim();
+  const ref = String(quote.ref || '').trim();
+  const snippet = String(quote.snippet || '').trim();
+  if (!kind || !ref) return '';
+  const fetchHint = kind === 'briefing'
+    ? `ticlawk briefing get ${ref}`
+    : kind === 'dashboard'
+      ? `ticlawk dashboard get --target "#${ref}"`
+      : kind === 'message'
+        ? `ticlawk message read --around ${ref}`
+        : '';
+  const lines = ['[quote', `  kind=${kind} ref=${ref}`];
+  if (snippet) lines.push(`  "${snippet.replace(/"/g, '\\"')}"`);
+  if (fetchHint) lines.push(`  fetch: ${fetchHint}`);
+  lines.push('[/quote]');
+  return lines.join('\n');
+}
+
 // Wrap each per-turn message with an explicit reply instruction so the
 // runtime LLM never has to remember the standing prompt to figure out
 // HOW to reply. Codex in particular treats the developerInstructions as
 // background and ignores the chat-send pattern without this per-turn
 // nudge.
-function buildWakePromptText({ envelopeHeader, target, rawText, groupContext, charterBlock, cosAddendum }) {
+function buildWakePromptText({ envelopeHeader, target, rawText, groupContext, charterBlock, cosAddendum, quoteBlock }) {
   const body = `${envelopeHeader} ${rawText || ''}`.trim();
   const lines = [];
   if (charterBlock) {
@@ -194,6 +221,9 @@ function buildWakePromptText({ envelopeHeader, target, rawText, groupContext, ch
   if (cosAddendum) {
     lines.push(cosAddendum, '');
   }
+  if (quoteBlock) {
+    lines.push(quoteBlock, '');
+  }
   lines.push('New message received:', '', body);
   if (groupContext) {
     lines.push('', groupContext);
@@ -230,8 +260,9 @@ export function normalizeInboundMessage(msg) {
   const groupContext = buildGroupContextBlock(enriched);
   const charterBlock = buildCharterBlock(enriched);
   const cosAddendum = buildCosAddendum(enriched);
+  const quoteBlock = buildQuoteBlock(enriched);
   const text = header
-    ? buildWakePromptText({ envelopeHeader: header, target, rawText, groupContext, charterBlock, cosAddendum })
+    ? buildWakePromptText({ envelopeHeader: header, target, rawText, groupContext, charterBlock, cosAddendum, quoteBlock })
     : rawText;
   return {
     bindingId: recipientAgentId,

package/src/cli/agent-commands.mjs

@@ -1022,6 +1022,21 @@ export async function runServiceCallCommand(args) {
   return exitFromStatus(res.statusCode);
 }
 
+export async function runBriefingGetCommand(args) {
+  const env = requireAgentEnv();
+  const id = args._[2] || getArg(args, 'id');
+  if (!id) { console.error('briefing id required (positional or --id)'); return 2; }
+  const params = new URLSearchParams();
+  params.set('id', id);
+  const res = await daemonRequest({
+    method: 'GET',
+    path: `/agent/briefing/get?${params}`,
+    headers: commonHeaders(env),
+  });
+  printJson(res.body);
+  return exitFromStatus(res.statusCode);
+}
+
 export async function runBriefingPublishCommand(args) {
   const env = requireAgentEnv();
   const textArg = getArg(args, 'text');
@@ -1272,13 +1287,18 @@ export const AGENT_COMMAND_HELP = {
   service call --name X    # input from stdin (JSON)
     Any agent. Backend proxies to endpoint_config.url. No retry.
 `,
-  briefing: `ticlawk briefing publish (--text "..." | --html <path>)
+  briefing: `ticlawk briefing <publish|get>
+  briefing publish (--text "..." | --html <path>)
     CoS-only. Publish a briefing to the owner's Office → Briefings.
     --text  short plain text (≤100 chars), use for one-liner pings
     --html  path to an HTML file; body is rendered as a full-screen card
     Briefings are independent of chat — they do NOT appear in the CoS
     DM message stream. Use this verb (not \`message send\`) for any
     status surface the owner consumes in Office.
+  briefing get <id>
+    Fetch a briefing including body_text/body_html. Use this when a
+    quote (metadata.quote.kind=briefing) points at a briefing whose
+    full body you want to read.
 `,
   credential: `ticlawk credential request --name <ENV_VAR> [--description Y] [--workstream "#<ws>"]
     CoS-only. Pre-allocate a credential slot. Response includes a deep

package/src/core/agent-cli-handlers.mjs

@@ -908,6 +908,20 @@ export async function handleServiceCall(req, body, ctx) {
   }
 }
 
+export async function handleBriefingGet(req, query, ctx) {
+  const actingAgentId = getActingAgentId(req, query);
+  const v = validateActingAgent(actingAgentId, ctx);
+  if (!v.ok) return { status: v.status, body: { error: v.error } };
+  const briefingId = String(query?.id || '').trim();
+  if (!briefingId) return { status: 400, body: { error: 'id is required' } };
+  try {
+    const data = await api.getBriefing({ actingAgentId, briefingId });
+    return { status: 200, body: data };
+  } catch (err) {
+    return { status: err?.status || 500, body: { error: err?.message || 'briefing get failed' } };
+  }
+}
+
 export async function handleBriefingPublish(req, body, ctx) {
   const actingAgentId = getActingAgentId(req, body);
   const v = validateActingAgent(actingAgentId, ctx);

package/src/core/http.mjs

@@ -14,6 +14,7 @@ import {
   handleWorkstreamDashboardGet,
   handleCredentialRequest,
   handleBriefingPublish,
+  handleBriefingGet,
   handleServiceCreate,
   handleServiceUpdate,
   handleServiceDelete,
@@ -294,6 +295,10 @@ export function startLocalHttpServer({ port, adapter, ctx }) {
         const r = await handleBriefingPublish(req, body, cliCtx);
         return writeJson(res, r.status, r.body);
       }
+      if (urlNoQuery === '/agent/briefing/get' && method === 'GET') {
+        const r = await handleBriefingGet(req, parseQuery(req.url || ''), cliCtx);
+        return writeJson(res, r.status, r.body);
+      }
       if (urlNoQuery === '/agent/credential/request' && method === 'POST') {
         const body = await readJsonBody(req);
         if (body === null) return writeJson(res, 400, { error: 'invalid json body' });

package/src/runtimes/_shared/standing-prompt.mjs

@@ -22,6 +22,7 @@ to users or groups.
 - Always claim a task via \`ticlawk task claim\` before doing any substantive work on it. If the claim fails, stop immediately and pick a different task.
 - Use only the provided \`ticlawk\` CLI commands for messaging.
 - If the turn opens with a \`[charter] ... [/charter]\` block, that is the workstream's binding spec (规章制度). Every action you take in this conversation must conform to it. If a request conflicts with the charter, stop and surface the conflict to the Chief of Staff (CoS) — don't silently route around it.
+- If the turn opens with a \`[quote ... [/quote]\` block, the user is replying with a quoted artifact in context. The block carries \`kind=<message|briefing|dashboard>\`, \`ref=<id>\`, a snippet, and a \`fetch:\` command to read the full content if you need it. Treat the user's text as a response *to* that artifact.
 - Shared services are CoS-published tools you can invoke. \`ticlawk service list\` shows available names + descriptions; \`ticlawk service info --name X\` shows the input contract; \`ticlawk service call --name X\` runs it with stdin JSON input. There is no retry — call failure means stop and report; do not loop.
 
 ## Startup checklist (every turn)