@sema-agent/client-core 0.2.0

package/dist/steering.js

@@ -0,0 +1,103 @@
+/**
+ * steering.ts — `steering_injected` → renderable attachment projection (PURE)。
+ * cli src/sema/steeringAttachments.ts 的逐字搬运(#52a;差分守卫钉两侧等价)。
+ *
+ * core 1.251 (design/133, board [479] ask-1) echoes every engine-side SYSTEM steering injection as a
+ * `steering_injected` wire event `{source, preview}` — `preview` = the injected body's first 220 chars
+ * (runtask.ts:2320), echo-only (the model-facing message is unchanged). Sources today:
+ * `deadline_nudge` / `finalize` (TB telemetry B3) and the design/133 turn-boundary attachment
+ * producers `todo_reminder` / `task_reminder` / `changed_files` / `plan_mode`, plus the G1 [482]
+ * members `background_tasks` / `tools_delta` (core 1.253).
+ *
+ * [479] ask-1 contract: a renderer that branches on `source` MUST carry a default arm — core may add
+ * sources without a cross-repo lockstep. This mapper is that branch point: known sources get their
+ * copy (the 四值文案), everything else falls to the generic default row (never dropped, never a
+ * crash). PURE (no env/IO) so it unit-tests without the render graph — the wireCaps pattern.
+ *
+ * Render policy (CC 2.1.198 parity): CC NULL-renders its own turn-boundary reminders
+ * (`todo_reminder` / `task_reminder` / `plan_mode` are in NULL_RENDERING_TYPES — the user never sees
+ * them in the normal transcript). The projected `steering_injected` attachment therefore renders
+ * ONLY in transcript (ctrl+o) / verbose mode (AttachmentMessage arm) — normal-mode output stays
+ * byte-identical to CC, while sema's two-process split keeps engine-side injections observable.
+ */
+/** Per-source display copy. [479] ask-1 四值 + the pre-existing TB sources. Open set — an unknown
+ *  source falls to the default label (never dropped). */
+const SOURCE_LABELS = {
+    todo_reminder: 'Todo list reminder re-surfaced to the model',
+    task_reminder: 'Task list reminder re-surfaced to the model',
+    changed_files: 'Externally modified files flagged to the model (re-read before editing)',
+    plan_mode: 'Plan mode constraint re-surfaced to the model',
+    deadline_nudge: 'Deadline nudge injected',
+    finalize: 'Finalize instruction injected',
+    // G1 [482]/[487]② — background_tasks normally projects to VISIBLE task_status rows below; this
+    // label is its parse-failure fallback (clipped-beyond-recognition preview) + the tools_delta row.
+    background_tasks: 'Background tasks from before compaction announced to the model',
+    tools_delta: 'Newly available tools announced to the model',
+};
+/** Default-arm label for a source this shell build predates. */
+export function steeringLabel(source) {
+    return SOURCE_LABELS[source] ?? `Steering injected (${source})`;
+}
+/**
+ * core turn-attachments.ts renderBackgroundTasks line shape (198 vbl VERBATIM phrases):
+ *   `- [${task_id}] Task "${description}" ${phrase}`
+ * phrase: completed → "completed in background" · killed → "stopped" · running → "still running in
+ * background" · anything else → the raw status word (core's own fallback arm). The wire preview is
+ * clipped at 220 chars, so the LAST line may be cut — a non-matching line is skipped, never fails
+ * the batch.
+ */
+const PHRASE_TO_STATUS = [
+    ['completed in background', 'completed'],
+    ['still running in background', 'running'],
+    ['stopped', 'killed'],
+    // core's raw-status fallback arm for the non-vbl states (announce snapshots pending/running, but
+    // parse defensively — a settle can race the boundary).
+    ['pending', 'pending'],
+    ['running', 'running'],
+    ['completed', 'completed'],
+    ['failed', 'failed'],
+    ['killed', 'killed'],
+];
+function parseBackgroundTaskLine(line) {
+    const trimmed = line.trim();
+    for (const [phrase, status] of PHRASE_TO_STATUS) {
+        const suffix = `" ${phrase}`;
+        if (!trimmed.endsWith(suffix))
+            continue;
+        const head = trimmed.slice(0, trimmed.length - suffix.length);
+        const m = /^- \[([^\]]+)\] Task "([\s\S]*)$/.exec(head);
+        if (!m)
+            return null;
+        return {
+            type: 'task_status',
+            taskId: m[1],
+            taskType: 'local_bash',
+            status,
+            description: m[2],
+            deltaSummary: null,
+        };
+    }
+    return null;
+}
+/**
+ * Project one `steering_injected` wire event into its renderable attachment(s). Always returns at
+ * least one attachment (default 兜底) — an engine injection is never silently invisible in
+ * transcript mode, whatever the source.
+ *
+ * `background_tasks` ([487]② G1): the preview lines parse into CC `task_status` attachments — the
+ * SAME (VISIBLE) GenericTaskStatus/vbl rendering the LOCAL post-compact path uses, three-state copy
+ * 198 verbatim, `[task_id]` addressable via TaskOutput/TaskStop. A preview clipped beyond
+ * recognition falls back to the generic (transcript-only) row — never invisible, never a crash.
+ */
+export function steeringInjectedToAttachments(source, preview) {
+    if (source === 'background_tasks') {
+        const tasks = preview
+            .split('\n')
+            .map(parseBackgroundTaskLine)
+            .filter((t) => t !== null);
+        if (tasks.length > 0)
+            return tasks;
+        // fall through: clipped/unrecognized body → generic row (default 兜底)
+    }
+    return [{ type: 'steering_injected', source, label: steeringLabel(source), preview }];
+}

package/dist/workflow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * workflow 车道纯函数(抽自 sema-cli footerRowBelt/workflowTaskOutputProjection,围栏见
+ * cli 仓 frameLaneGuards/taskOutputWorkflowEnvelope 套;[1617] 幽灵行家族的判别资产)。
+ */
+/** core 1.356 BCE 合成 workflow-agent id 形:wa+16hex。
+ *  真实 fleet 子行 id 是 `${runId} ${engineTaskId}` 复合形——必须取空白分隔尾段再匹配
+ *  (cli footerRowBelt 原版语义;codex 对抗复审抓的等价性破坏,0.1.1 修)。 */
+export declare function isWorkflowAgentTaskId(taskId: string): boolean;
+/** TaskOutput workflow 轮询信封识别(core task-registry formatWorkflowRun 真形:
+ *  {task_id, type:"workflow", status, name?, …};type+task_id 双门,非该形返回 null)。 */
+export declare function parseWorkflowPollEnvelope(body: string): {
+    taskId: string;
+    status: string;
+    name?: string;
+} | null;
+/** workflow 轮询 JSON → 人话多行投影(agents 汇总行 + per-agent ✓/✗ 明细 + note/error 尾透传);
+ *  非 JSON 原样返回(fail-soft)。 */
+export declare function projectWorkflowTaskOutput(jsonSrc: string): string;

package/dist/workflow.js

@@ -0,0 +1,60 @@
+/**
+ * workflow 车道纯函数(抽自 sema-cli footerRowBelt/workflowTaskOutputProjection,围栏见
+ * cli 仓 frameLaneGuards/taskOutputWorkflowEnvelope 套;[1617] 幽灵行家族的判别资产)。
+ */
+/** core 1.356 BCE 合成 workflow-agent id 形:wa+16hex。
+ *  真实 fleet 子行 id 是 `${runId} ${engineTaskId}` 复合形——必须取空白分隔尾段再匹配
+ *  (cli footerRowBelt 原版语义;codex 对抗复审抓的等价性破坏,0.1.1 修)。 */
+export function isWorkflowAgentTaskId(taskId) {
+    const tail = taskId.split(/\s+/).pop() ?? taskId;
+    return /^wa[0-9a-f]{16}$/.test(tail);
+}
+/** TaskOutput workflow 轮询信封识别(core task-registry formatWorkflowRun 真形:
+ *  {task_id, type:"workflow", status, name?, …};type+task_id 双门,非该形返回 null)。 */
+export function parseWorkflowPollEnvelope(body) {
+    try {
+        const j = JSON.parse(body);
+        if (j.type !== 'workflow' || typeof j.task_id !== 'string' || j.task_id.length === 0)
+            return null;
+        return {
+            taskId: j.task_id,
+            status: typeof j.status === 'string' && j.status.length > 0 ? j.status : 'completed',
+            ...(typeof j.name === 'string' && j.name.length > 0 ? { name: j.name } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** workflow 轮询 JSON → 人话多行投影(agents 汇总行 + per-agent ✓/✗ 明细 + note/error 尾透传);
+ *  非 JSON 原样返回(fail-soft)。 */
+export function projectWorkflowTaskOutput(jsonSrc) {
+    try {
+        const j = JSON.parse(jsonSrc);
+        const parts = [];
+        if (j.agents && typeof j.agents.done === 'number' && typeof j.agents.total === 'number') {
+            parts.push(`agents: ${j.agents.done}/${j.agents.total} done${typeof j.agents.failed === 'number' && j.agents.failed > 0 ? ` (${j.agents.failed} failed)` : ''}`);
+        }
+        if (Array.isArray(j.agent_runs)) {
+            for (const r of j.agent_runs) {
+                if (!r || typeof r !== 'object')
+                    continue;
+                const label = typeof r.label === 'string' && r.label.length > 0 ? r.label : '(agent)';
+                const st = typeof r.status === 'string' ? r.status : '?';
+                const errLine = typeof r.error === 'string' && r.error.length > 0 ? ` — ${r.error.split('\n')[0].slice(0, 120)}` : '';
+                const outLine = !errLine && typeof r.output === 'string' && r.output.length > 0
+                    ? ` — ${r.output.split('\n')[0].slice(0, 80)}`
+                    : '';
+                parts.push(`  ${st === 'completed' ? '✓' : st === 'failed' ? '✗' : '·'} ${label} [${st}]${errLine}${outLine}`);
+            }
+        }
+        if (typeof j.note === 'string' && j.note.length > 0)
+            parts.push(j.note);
+        if (typeof j.error === 'string' && j.error.length > 0)
+            parts.push(j.error);
+        return parts.join('\n');
+    }
+    catch {
+        return jsonSrc;
+    }
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@sema-agent/client-core",
+  "version": "0.2.0",
+  "description": "Client-side session runtime shared by every sema human client (TUI / web / desktop): sema wire frames (AgentEvent) -> CC session vocabulary (SDKMessage) with dual-plane output (transcript/chrome), deterministic transcript ids, lane discipline as a type, and the notification/dedup ledgers. Every CC-skin shape is collected here so the wire itself stays neutral. Blackboard [1832] design axioms; [1651]/[1652]/[1653] signed seam design. Renamed from @sema-agent/wire-cc-adapter (0.1.x).",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": "github:sema-agent/sema-client-core",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node scripts/run-client-core-pure-test.mjs && node scripts/run-client-core-diff-test.mjs"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@sema-agent/agent-types": ">=0.2.0",
+    "@sema-agent/sdk": ">=0.0.100"
+  },
+  "devDependencies": {
+    "@sema-agent/agent-types": "^0.2.0",
+    "@sema-agent/sdk": "^0.0.106",
+    "esbuild": "^0.27.4",
+    "typescript": "^6.0.2"
+  }
+}