@botlearn-course/daemon 0.0.13 → 0.0.15

package/dist/tool-observation.js

@@ -0,0 +1,120 @@
+import path from "node:path";
+import { REDACTED, redactSecretsDeep, } from "./redaction.js";
+export const AGENT_TOOL_OBSERVATION_SCHEMA_VERSION = "agent-tool-observation/0.1";
+const DETAIL_MAX_CHARS = 4_000;
+const MAX_PROJECT_DEPTH = 8;
+const SAFE_TOOL_NAME = /^[A-Za-z0-9][A-Za-z0-9._:/-]{0,79}$/;
+const CALL_FIELDS = new Set([
+    "arguments",
+    "args",
+    "input",
+    "command",
+    "cmd",
+    "cwd",
+    "path",
+    "file_path",
+    "query",
+    "url",
+    "pattern",
+    "patch",
+    "changes",
+    "edits",
+]);
+const RESULT_FIELDS = new Set([
+    "result",
+    "output",
+    "stdout",
+    "stderr",
+    "exit_code",
+    "status",
+    "status_code",
+    "error",
+    "diff",
+    "path",
+    "file_path",
+    "bytes",
+]);
+/**
+ * Project a provider tool envelope into durable teacher evidence.
+ *
+ * The projection is deliberately lossy: only operational argument/result fields survive,
+ * credentials are removed, host paths become workspace-relative, and the JSON preview is
+ * bounded. Provider reasoning, message text, request IDs, and arbitrary envelope metadata
+ * never cross this boundary.
+ */
+export function buildToolObservation(block, runtime, workspaceDir) {
+    if (block.kind !== "tool_call" && block.kind !== "tool_result")
+        return null;
+    const fields = block.kind === "tool_call" ? CALL_FIELDS : RESULT_FIELDS;
+    const projected = collectAllowedFields(block.raw, fields);
+    if (typeof block.text === "string" && block.text) {
+        projected[block.kind === "tool_call" ? "target" : "summary"] = block.text;
+    }
+    const normalized = normalizeWorkspacePaths(redactSecretsDeep(projected), path.resolve(workspaceDir));
+    const serialized = Object.keys(projected).length > 0
+        ? JSON.stringify(normalized, null, 2)
+        : "";
+    const detailTruncated = serialized.length > DETAIL_MAX_CHARS;
+    const detailPreview = detailTruncated
+        ? `${serialized.slice(0, DETAIL_MAX_CHARS - 1)}…`
+        : serialized;
+    return {
+        schema_version: AGENT_TOOL_OBSERVATION_SCHEMA_VERSION,
+        kind: block.kind,
+        runtime,
+        status: block.kind === "tool_call"
+            ? "started"
+            : block.status === "error"
+                ? "error"
+                : "completed",
+        ...(block.name && SAFE_TOOL_NAME.test(block.name) ? { name: block.name } : {}),
+        ...(detailPreview ? { detail_preview: detailPreview } : {}),
+        detail_truncated: detailTruncated,
+        redacted: detailPreview.includes(REDACTED),
+    };
+}
+function collectAllowedFields(value, allowed, depth = 0, out = {}) {
+    if (value === null || typeof value !== "object" || depth >= MAX_PROJECT_DEPTH) {
+        return out;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value.slice(0, 50)) {
+            collectAllowedFields(item, allowed, depth + 1, out);
+        }
+        return out;
+    }
+    for (const [key, item] of Object.entries(value)) {
+        if (allowed === RESULT_FIELDS
+            && key === "content"
+            && value.type === "tool_result") {
+            if (!("content" in out))
+                out.content = item;
+            continue;
+        }
+        if (allowed.has(key)) {
+            if (!(key in out))
+                out[key] = item;
+            continue;
+        }
+        collectAllowedFields(item, allowed, depth + 1, out);
+    }
+    return out;
+}
+function normalizeWorkspacePaths(value, workspaceDir) {
+    if (typeof value === "string") {
+        const normalizedWorkspace = workspaceDir.replaceAll("\\", "/").replace(/\/+$/, "");
+        const normalizedValue = value.replaceAll("\\", "/");
+        return normalizedValue
+            .replaceAll(`${normalizedWorkspace}/`, "")
+            .replaceAll(normalizedWorkspace, ".");
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeWorkspacePaths(item, workspaceDir));
+    }
+    if (value === null || typeof value !== "object")
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+        key,
+        normalizeWorkspacePaths(item, workspaceDir),
+    ]));
+}

package/dist/types.d.ts

@@ -5,6 +5,7 @@
  * `services/course-api/botlearn_course/schemas.py` 的 daemon 契约严格对齐。
  */
 import type { ProgressStatus } from "./mcp/report-progress.js";
+import type { PreparedRuntimeSkillProvider, RuntimeSkillEvent } from "./runtime-skills.js";
 export interface RunInputAttachment {
     attachment_id: string;
     filename: string;
@@ -53,7 +54,7 @@ export interface RunStartPayload {
  * `POST /daemon/runs/{id}/events` 接受的事件类型。
  * 与后端 DaemonRunEventIn.type 的 Literal 严格一致 —— 发送其他类型会得到 422。
  */
-export type RunEventType = "run.accepted" | "run.started" | "run.block" | "run.message" | "run.completed" | "run.failed" | "run.cancelled";
+export type RunEventType = "run.accepted" | "run.started" | "run.block" | "run.observation" | "run.message" | "run.completed" | "run.failed" | "run.cancelled";
 export interface RunEvent {
     type: RunEventType;
     /** End-to-end correlation id assigned by Course Service. */
@@ -125,7 +126,10 @@ export interface AppliedRunRuntimeProfile {
 export interface RuntimeContentBlock {
     kind: "text_delta" | "text" | "thinking" | "tool_call" | "tool_result" | "status" | "error";
     text?: string;
-    /** Safe provider-normalized tool identifier. Raw arguments/results stay in the transcript only. */
+    /**
+     * Safe provider-normalized tool identifier. Raw envelopes stay local; the dispatcher may
+     * derive a separate bounded/redacted teacher observation from explicit operation fields.
+     */
     name?: string;
     /** Public lifecycle metadata; never carries provider reasoning or tool output. */
     phase?: "in_progress" | "completed";
@@ -149,13 +153,26 @@ export interface RuntimeProgressDispositions {
 }
 /** Content-free model usage; adapters populate only fields actually reported upstream. */
 export interface RuntimeUsage {
+    /** Model identity resolved by the runtime/provider, not inferred by the daemon. */
+    model?: string;
     input_tokens?: number;
     cached_input_tokens?: number;
     output_tokens?: number;
+    reasoning_tokens?: number;
     total_tokens?: number;
     cost_usd?: number;
     provider_request_ids?: string[];
 }
+/** Content-free shape of one runtime-native completion. */
+export interface RuntimeCompletionSummary {
+    assistant_message_count: number;
+    reasoning_message_count: number;
+    assistant_content_present: boolean;
+    reasoning_content_present: boolean;
+    tool_call_count: number;
+    turn_status?: string;
+    finish_reason?: string;
+}
 export interface RuntimeAuthProbe {
     checked: boolean;
     ok: boolean;
@@ -179,6 +196,8 @@ export interface CourseRuntimeSink {
     usage?(usage: RuntimeUsage): Promise<void>;
     /** Persist the runtime-native thread/session id before a terminal turn event is emitted. */
     runtimeSession?(sessionId: string): Promise<void>;
+    /** Content-free technical evidence from the control-side Runtime Skill Provider. */
+    skillEvent?(event: RuntimeSkillEvent): Promise<void>;
 }
 /** 一次 run 的本地执行上下文：服务器 payload + daemon 本地准备产物。 */
 export interface RunExecution {
@@ -195,6 +214,8 @@ export interface RunExecution {
     runtimeEnv?: NodeJS.ProcessEnv;
     /** Verified learner files materialized beneath the runtime workspace. */
     inputAttachments?: MaterializedInputAttachment[];
+    /** Activation-scoped provider held by the daemon control process, never runtime env. */
+    skillProvider?: PreparedRuntimeSkillProvider;
 }
 export interface CourseRuntime {
     id: string;
@@ -226,7 +247,10 @@ export interface RuntimeFailureSummary {
     stderr_tail?: string;
     stdout_tail?: string;
     error_name?: string;
+    error_code?: string;
     error_message?: string;
+    model?: string;
+    completion?: RuntimeCompletionSummary;
 }
 export interface RuntimeModule {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botlearn-course/daemon",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Lightweight BotLearn Course daemon: run course tasks on your own machine with your own agent runtime (BYOA).",
   "type": "module",
   "bin": {