@geminixiang/mikan 1.0.0-beta.74 → 1.0.0-beta.76

package/dist/adapters/slack/task-intent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-intent.d.ts","sourceRoot":"","sources":["../../../src/adapters/slack/task-intent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAG1B;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAWxD,uGAAuG;AACvG,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrE,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,MAAM,CA0BR;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GACzD,OAAO,CAAC,UAAU,CAAC,CAiCrB"}
+{"version":3,"file":"task-intent.d.ts","sourceRoot":"","sources":["../../../src/adapters/slack/task-intent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAG1B;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAWxD,uGAAuG;AACvG,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrE,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,MAAM,CA0BR;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GACzD,OAAO,CAAC,UAAU,CAAC,CAqCrB"}

package/dist/adapters/slack/task-intent.js

@@ -48,7 +48,7 @@ export async function classifyTaskIntent(state, text, context) {
                 instructions: "Given the tasks in play and the recent conversation, what does the NEW message mean?",
                 criteria: TASK_INTENT_CRITERIA,
             },
-        });
+        }, { caller: "task_intent" });
         const choice = result.answers.intent.choice;
         const probabilities = result.answers.intent.probabilities;
         log.logInfo(`[${context.conversationId}] jev task intent: ${choice}${probabilities ? ` ${JSON.stringify(probabilities)}` : ""} text="${text.slice(0, 80)}"`);

package/dist/adapters/slack/task-intent.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-intent.js","sourceRoot":"","sources":["../../../src/adapters/slack/task-intent.ts"],"names":[],"mappings":"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","sourcesContent":["import { evaluateWithJev, JevNotConfiguredError } from \"../../harness/index.js\";\nimport { reportUserFacingError } from \"../../observability/index.js\";\nimport * as log from \"../../log.js\";\nimport type { TaskStatus } from \"../../types.js\";\nimport {\n  formatRecentScope,\n  humanizeMentions,\n  readRecentScope,\n  type SlackNameResolver,\n} from \"./jev-context.js\";\nimport { isTaskStatusQuestion } from \"./task-status.js\";\n\n/**\n * What a DM message means while a task is around:\n * - `status`: a pure progress question, answered from observation without a model turn\n * - `steer`: a supplement or correction for the running work, folded into its next step\n * - `request`: anything else, handled as an ordinary conversation turn\n */\nexport type TaskIntent = \"status\" | \"steer\" | \"request\";\n\nconst TASK_INTENT_CRITERIA = {\n  status:\n    \"Only asks whether the ongoing work is done, how it is going, what step it is on, or how long it will take. Contains no new instruction, constraint, correction, or request for content.\",\n  steer:\n    \"Adds information, a constraint, a correction, or a change of direction for the ongoing work while it continues (e.g. 先不要部署, also check the staging config, use the other branch). May be combined with a progress question.\",\n  request:\n    \"A new standalone question or request unrelated to steering the ongoing work, a reaction to a finished result, or anything else.\",\n} as const;\n\n/** The shared `state` Jev scores: the scope's recent lines, the tasks in play, and the new message. */\nexport function buildTaskIntentState(\n  conversationDir: string,\n  event: { ts: string; thread_ts?: string; user: string; text: string },\n  options: {\n    speaker?: string;\n    tasks: TaskStatus[];\n    resolveName?: SlackNameResolver;\n    botUserId?: string | null;\n  },\n): string {\n  const resolve = options.resolveName ?? (() => undefined);\n  const humanize = (text: string) => humanizeMentions(text, resolve, options.botUserId ?? null);\n  const recent = readRecentScope(conversationDir, event, { humanize });\n  const tasks = options.tasks.length\n    ? options.tasks\n        .map(\n          (t) =>\n            `- ${t.status}${t.currentTool ? ` (currently: ${t.currentTool})` : \"\"}: ${t.acknowledgement}`,\n        )\n        .join(\"\\n\")\n    : \"(none)\";\n  return [\n    event.thread_ts\n      ? \"Slack DM reply inside a background task thread.\"\n      : \"Slack DM top-level message while background tasks exist.\",\n    \"\",\n    \"Tasks in this DM (most recent first):\",\n    tasks,\n    \"\",\n    \"Recent messages in this scope (oldest first):\",\n    formatRecentScope(recent),\n    \"\",\n    `NEW message from ${options.speaker ?? event.user}:`,\n    humanize(event.text),\n  ].join(\"\\n\");\n}\n\n/**\n * Classify with Jev. When Jev is unavailable or fails, reproduce the pre-Jev\n * behavior exactly: the regex shortcut decides `status`, and other text is\n * `steer` inside a task thread (where it always targeted that task) or\n * `request` at top level.\n */\nexport async function classifyTaskIntent(\n  state: string,\n  text: string,\n  context: { conversationId: string; inTaskThread: boolean },\n): Promise<TaskIntent> {\n  const fallback = (): TaskIntent =>\n    isTaskStatusQuestion(text) ? \"status\" : context.inTaskThread ? \"steer\" : \"request\";\n  try {\n    const result = await evaluateWithJev(state, {\n      intent: {\n        type: \"choice\",\n        instructions:\n          \"Given the tasks in play and the recent conversation, what does the NEW message mean?\",\n        criteria: TASK_INTENT_CRITERIA,\n      },\n    });\n    const choice = result.answers.intent.choice;\n    const probabilities = result.answers.intent.probabilities;\n    log.logInfo(\n      `[${context.conversationId}] jev task intent: ${choice}${\n        probabilities ? ` ${JSON.stringify(probabilities)}` : \"\"\n      } text=\"${text.slice(0, 80)}\"`,\n    );\n    if (choice === \"status\" || choice === \"steer\" || choice === \"request\") return choice;\n    return fallback();\n  } catch (err) {\n    if (!(err instanceof JevNotConfiguredError)) {\n      reportUserFacingError(err, {\n        domain: \"chat_platform\",\n        surface: \"slack_task_intent_jev\",\n        operation: \"evaluate\",\n        severity: \"warning\",\n        context: { conversationId: context.conversationId },\n      });\n    }\n    return fallback();\n  }\n}\n"]}
+{"version":3,"file":"task-intent.js","sourceRoot":"","sources":["../../../src/adapters/slack/task-intent.ts"],"names":[],"mappings":"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","sourcesContent":["import { evaluateWithJev, JevNotConfiguredError } from \"../../harness/index.js\";\nimport { reportUserFacingError } from \"../../observability/index.js\";\nimport * as log from \"../../log.js\";\nimport type { TaskStatus } from \"../../types.js\";\nimport {\n  formatRecentScope,\n  humanizeMentions,\n  readRecentScope,\n  type SlackNameResolver,\n} from \"./jev-context.js\";\nimport { isTaskStatusQuestion } from \"./task-status.js\";\n\n/**\n * What a DM message means while a task is around:\n * - `status`: a pure progress question, answered from observation without a model turn\n * - `steer`: a supplement or correction for the running work, folded into its next step\n * - `request`: anything else, handled as an ordinary conversation turn\n */\nexport type TaskIntent = \"status\" | \"steer\" | \"request\";\n\nconst TASK_INTENT_CRITERIA = {\n  status:\n    \"Only asks whether the ongoing work is done, how it is going, what step it is on, or how long it will take. Contains no new instruction, constraint, correction, or request for content.\",\n  steer:\n    \"Adds information, a constraint, a correction, or a change of direction for the ongoing work while it continues (e.g. 先不要部署, also check the staging config, use the other branch). May be combined with a progress question.\",\n  request:\n    \"A new standalone question or request unrelated to steering the ongoing work, a reaction to a finished result, or anything else.\",\n} as const;\n\n/** The shared `state` Jev scores: the scope's recent lines, the tasks in play, and the new message. */\nexport function buildTaskIntentState(\n  conversationDir: string,\n  event: { ts: string; thread_ts?: string; user: string; text: string },\n  options: {\n    speaker?: string;\n    tasks: TaskStatus[];\n    resolveName?: SlackNameResolver;\n    botUserId?: string | null;\n  },\n): string {\n  const resolve = options.resolveName ?? (() => undefined);\n  const humanize = (text: string) => humanizeMentions(text, resolve, options.botUserId ?? null);\n  const recent = readRecentScope(conversationDir, event, { humanize });\n  const tasks = options.tasks.length\n    ? options.tasks\n        .map(\n          (t) =>\n            `- ${t.status}${t.currentTool ? ` (currently: ${t.currentTool})` : \"\"}: ${t.acknowledgement}`,\n        )\n        .join(\"\\n\")\n    : \"(none)\";\n  return [\n    event.thread_ts\n      ? \"Slack DM reply inside a background task thread.\"\n      : \"Slack DM top-level message while background tasks exist.\",\n    \"\",\n    \"Tasks in this DM (most recent first):\",\n    tasks,\n    \"\",\n    \"Recent messages in this scope (oldest first):\",\n    formatRecentScope(recent),\n    \"\",\n    `NEW message from ${options.speaker ?? event.user}:`,\n    humanize(event.text),\n  ].join(\"\\n\");\n}\n\n/**\n * Classify with Jev. When Jev is unavailable or fails, reproduce the pre-Jev\n * behavior exactly: the regex shortcut decides `status`, and other text is\n * `steer` inside a task thread (where it always targeted that task) or\n * `request` at top level.\n */\nexport async function classifyTaskIntent(\n  state: string,\n  text: string,\n  context: { conversationId: string; inTaskThread: boolean },\n): Promise<TaskIntent> {\n  const fallback = (): TaskIntent =>\n    isTaskStatusQuestion(text) ? \"status\" : context.inTaskThread ? \"steer\" : \"request\";\n  try {\n    const result = await evaluateWithJev(\n      state,\n      {\n        intent: {\n          type: \"choice\",\n          instructions:\n            \"Given the tasks in play and the recent conversation, what does the NEW message mean?\",\n          criteria: TASK_INTENT_CRITERIA,\n        },\n      },\n      { caller: \"task_intent\" },\n    );\n    const choice = result.answers.intent.choice;\n    const probabilities = result.answers.intent.probabilities;\n    log.logInfo(\n      `[${context.conversationId}] jev task intent: ${choice}${\n        probabilities ? ` ${JSON.stringify(probabilities)}` : \"\"\n      } text=\"${text.slice(0, 80)}\"`,\n    );\n    if (choice === \"status\" || choice === \"steer\" || choice === \"request\") return choice;\n    return fallback();\n  } catch (err) {\n    if (!(err instanceof JevNotConfiguredError)) {\n      reportUserFacingError(err, {\n        domain: \"chat_platform\",\n        surface: \"slack_task_intent_jev\",\n        operation: \"evaluate\",\n        severity: \"warning\",\n        context: { conversationId: context.conversationId },\n      });\n    }\n    return fallback();\n  }\n}\n"]}

package/dist/adapters/slack/tools/blockkit.d.ts

@@ -2,6 +2,7 @@ import type { AgentTool } from "@earendil-works/pi-agent-core";
 export type { SlackBlockKitOps } from "../types.js";
 import type { SlackBlockKitOps } from "../types.js";
 declare const blockkitSchema: import("@sinclair/typebox").TObject<{
+    label: import("@sinclair/typebox").TString;
     blocks: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>;
     text: import("@sinclair/typebox").TString;
     thread_ts: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;

package/dist/adapters/slack/tools/blockkit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blockkit.d.ts","sourceRoot":"","sources":["../../../../src/adapters/slack/tools/blockkit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMpD,QAAA,MAAM,cAAc;;;;;EAoBlB,CAAC;AAyCH,wBAAgB,uBAAuB,IAAI;IACzC,IAAI,EAAE,SAAS,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,CAAC;CAC7D,CAgEA"}
+{"version":3,"file":"blockkit.d.ts","sourceRoot":"","sources":["../../../../src/adapters/slack/tools/blockkit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMpD,QAAA,MAAM,cAAc;;;;;;EAqBlB,CAAC;AAyCH,wBAAgB,uBAAuB,IAAI;IACzC,IAAI,EAAE,SAAS,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,CAAC;CAC7D,CAsEA"}

package/dist/adapters/slack/tools/blockkit.js

@@ -3,6 +3,7 @@ import { Type } from "@sinclair/typebox";
 const MAX_BLOCKS = 50;
 const MAX_ARGUMENT_BYTES = 64 * 1024;
 const blockkitSchema = Type.Object({
+    label: Type.String({ description: "Brief description of this action (shown to user)" }),
     blocks: Type.Array(Type.Unknown(), {
         maxItems: MAX_BLOCKS,
         description: `Slack Block Kit blocks (max ${MAX_BLOCKS}). Use {type:'markdown', text} for prose, {type:'table'} for tables, and actions/section blocks for buttons and select menus.`,

package/dist/adapters/slack/tools/blockkit.js.map

@@ -1 +1 @@
-{"version":3,"file":"blockkit.js","sourceRoot":"","sources":["../../../../src/adapters/slack/tools/blockkit.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nexport type { SlackBlockKitOps } from \"../types.js\";\nimport type { SlackBlockKitOps } from \"../types.js\";\n\n/** Slack's own ceilings: 50 blocks per message, and a payload well under 64KB. */\nconst MAX_BLOCKS = 50;\nconst MAX_ARGUMENT_BYTES = 64 * 1024;\n\nconst blockkitSchema = Type.Object({\n  blocks: Type.Array(Type.Unknown(), {\n    maxItems: MAX_BLOCKS,\n    description: `Slack Block Kit blocks (max ${MAX_BLOCKS}). Use {type:'markdown', text} for prose, {type:'table'} for tables, and actions/section blocks for buttons and select menus.`,\n  }),\n  text: Type.String({\n    description: \"Plain-text fallback shown in notifications and screen readers\",\n  }),\n  thread_ts: Type.Optional(\n    Type.String({\n      description:\n        \"Optional active-thread TS. Posts are always constrained to the current conversation thread.\",\n    }),\n  ),\n  update_ts: Type.Optional(\n    Type.String({\n      description:\n        \"Update a message previously posted by slack_blockkit in this conversation instead of posting a new one.\",\n    }),\n  ),\n});\n\n/**\n * Reject a runaway payload before schema validation sees it.\n *\n * `prepareArguments` runs ahead of validation, which reports a failure by\n * embedding the entire argument object in its message. A malformed multi-\n * hundred-KB `blocks` array therefore lands in the session twice — once as the\n * call, once echoed back as the result — and every later reader pays for it.\n * Only a bounded result belongs there, so the size complaint stays short and\n * never quotes what it rejected.\n */\nfunction guardBlockKitArguments(args: unknown): unknown {\n  if (!args || typeof args !== \"object\") return args;\n  const bytes = Buffer.byteLength(JSON.stringify(args) ?? \"\", \"utf-8\");\n  if (bytes > MAX_ARGUMENT_BYTES) {\n    throw new Error(\n      `slack_blockkit arguments are ${Math.round(bytes / 1024)}KB, over the ${MAX_ARGUMENT_BYTES / 1024}KB limit. ` +\n        \"Post a short message and attach the long content as a file instead.\",\n    );\n  }\n  const blocks = (args as { blocks?: unknown }).blocks;\n  if (Array.isArray(blocks) && blocks.length > MAX_BLOCKS) {\n    throw new Error(`slack_blockkit accepts at most ${MAX_BLOCKS} blocks, got ${blocks.length}.`);\n  }\n  return args;\n}\n\nfunction formatSlackApiError(err: unknown): Error {\n  const data = (\n    err as { data?: { error?: string; response_metadata?: { messages?: string[] } } } | undefined\n  )?.data;\n  if (!data?.error) return err instanceof Error ? err : new Error(String(err));\n  const details = data.response_metadata?.messages?.length\n    ? `\\n${data.response_metadata.messages.join(\"\\n\")}`\n    : \"\";\n  return new Error(\n    `Slack rejected the request: ${data.error}${details}\\nFix the blocks JSON and retry.`,\n  );\n}\n\nexport function createSlackBlockKitTool(): {\n  tool: AgentTool<typeof blockkitSchema>;\n  setSlackBlockKitOps: (ops: SlackBlockKitOps | null) => void;\n} {\n  let boundOps: SlackBlockKitOps | null = null;\n\n  const tool: AgentTool<typeof blockkitSchema> = {\n    name: \"slack_blockkit\",\n    label: \"slack_blockkit\",\n    description:\n      \"Post an interactive Slack Block Kit message (buttons, select menus, custom layouts) to the current conversation, or update one previously posted with this tool. Normal replies already render Markdown — use this only when you need interactive elements or a layout Markdown cannot express. When a user clicks a button or picks an option, you receive a new message '[Slack action] <action_id>: <value>' — choose descriptive action_ids and values so the interaction tells you what to do. Returns the message ts; pass it back as update_ts to edit the message later (e.g. refreshing vote tallies). After handling an interaction, update the message via update_ts to replace the buttons with the outcome (e.g. '✅ approved') — buttons stay clickable otherwise and repeated clicks re-trigger the action. If Slack rejects the blocks, the error includes its validation messages — fix the JSON and retry.\",\n    parameters: blockkitSchema,\n    prepareArguments: guardBlockKitArguments as (args: unknown) => typeof blockkitSchema.static,\n    execute: async (\n      _toolCallId: string,\n      {\n        blocks,\n        text,\n        thread_ts,\n        update_ts,\n      }: { blocks: unknown[]; text: string; thread_ts?: string; update_ts?: string },\n      signal?: AbortSignal,\n    ) => {\n      const ops = boundOps;\n      if (!ops) {\n        throw new Error(\"slack_blockkit is only available in Slack conversations\");\n      }\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n\n      try {\n        if (update_ts) {\n          await ops.updateBlocks({ ts: update_ts, text, blocks: blocks as object[] });\n          return {\n            content: [\n              { type: \"text\" as const, text: `Updated Block Kit message (ts: ${update_ts}).` },\n            ],\n            details: undefined,\n          };\n        }\n        const { ts } = await ops.postBlocks({\n          text,\n          blocks: blocks as object[],\n          threadTs: thread_ts,\n        });\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: `Posted Block Kit message (ts: ${ts}). Interactive elements will arrive as \"[Slack action] <action_id>: <value>\" messages; pass ts back as update_ts to edit this message.`,\n            },\n          ],\n          details: undefined,\n        };\n      } catch (err) {\n        throw formatSlackApiError(err);\n      }\n    },\n  };\n\n  return {\n    tool,\n    setSlackBlockKitOps: (ops) => {\n      boundOps = ops;\n    },\n  };\n}\n"]}
+{"version":3,"file":"blockkit.js","sourceRoot":"","sources":["../../../../src/adapters/slack/tools/blockkit.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nexport type { SlackBlockKitOps } from \"../types.js\";\nimport type { SlackBlockKitOps } from \"../types.js\";\n\n/** Slack's own ceilings: 50 blocks per message, and a payload well under 64KB. */\nconst MAX_BLOCKS = 50;\nconst MAX_ARGUMENT_BYTES = 64 * 1024;\n\nconst blockkitSchema = Type.Object({\n  label: Type.String({ description: \"Brief description of this action (shown to user)\" }),\n  blocks: Type.Array(Type.Unknown(), {\n    maxItems: MAX_BLOCKS,\n    description: `Slack Block Kit blocks (max ${MAX_BLOCKS}). Use {type:'markdown', text} for prose, {type:'table'} for tables, and actions/section blocks for buttons and select menus.`,\n  }),\n  text: Type.String({\n    description: \"Plain-text fallback shown in notifications and screen readers\",\n  }),\n  thread_ts: Type.Optional(\n    Type.String({\n      description:\n        \"Optional active-thread TS. Posts are always constrained to the current conversation thread.\",\n    }),\n  ),\n  update_ts: Type.Optional(\n    Type.String({\n      description:\n        \"Update a message previously posted by slack_blockkit in this conversation instead of posting a new one.\",\n    }),\n  ),\n});\n\n/**\n * Reject a runaway payload before schema validation sees it.\n *\n * `prepareArguments` runs ahead of validation, which reports a failure by\n * embedding the entire argument object in its message. A malformed multi-\n * hundred-KB `blocks` array therefore lands in the session twice — once as the\n * call, once echoed back as the result — and every later reader pays for it.\n * Only a bounded result belongs there, so the size complaint stays short and\n * never quotes what it rejected.\n */\nfunction guardBlockKitArguments(args: unknown): unknown {\n  if (!args || typeof args !== \"object\") return args;\n  const bytes = Buffer.byteLength(JSON.stringify(args) ?? \"\", \"utf-8\");\n  if (bytes > MAX_ARGUMENT_BYTES) {\n    throw new Error(\n      `slack_blockkit arguments are ${Math.round(bytes / 1024)}KB, over the ${MAX_ARGUMENT_BYTES / 1024}KB limit. ` +\n        \"Post a short message and attach the long content as a file instead.\",\n    );\n  }\n  const blocks = (args as { blocks?: unknown }).blocks;\n  if (Array.isArray(blocks) && blocks.length > MAX_BLOCKS) {\n    throw new Error(`slack_blockkit accepts at most ${MAX_BLOCKS} blocks, got ${blocks.length}.`);\n  }\n  return args;\n}\n\nfunction formatSlackApiError(err: unknown): Error {\n  const data = (\n    err as { data?: { error?: string; response_metadata?: { messages?: string[] } } } | undefined\n  )?.data;\n  if (!data?.error) return err instanceof Error ? err : new Error(String(err));\n  const details = data.response_metadata?.messages?.length\n    ? `\\n${data.response_metadata.messages.join(\"\\n\")}`\n    : \"\";\n  return new Error(\n    `Slack rejected the request: ${data.error}${details}\\nFix the blocks JSON and retry.`,\n  );\n}\n\nexport function createSlackBlockKitTool(): {\n  tool: AgentTool<typeof blockkitSchema>;\n  setSlackBlockKitOps: (ops: SlackBlockKitOps | null) => void;\n} {\n  let boundOps: SlackBlockKitOps | null = null;\n\n  const tool: AgentTool<typeof blockkitSchema> = {\n    name: \"slack_blockkit\",\n    label: \"slack_blockkit\",\n    description:\n      \"Post an interactive Slack Block Kit message (buttons, select menus, custom layouts) to the current conversation, or update one previously posted with this tool. Normal replies already render Markdown — use this only when you need interactive elements or a layout Markdown cannot express. When a user clicks a button or picks an option, you receive a new message '[Slack action] <action_id>: <value>' — choose descriptive action_ids and values so the interaction tells you what to do. Returns the message ts; pass it back as update_ts to edit the message later (e.g. refreshing vote tallies). After handling an interaction, update the message via update_ts to replace the buttons with the outcome (e.g. '✅ approved') — buttons stay clickable otherwise and repeated clicks re-trigger the action. If Slack rejects the blocks, the error includes its validation messages — fix the JSON and retry.\",\n    parameters: blockkitSchema,\n    prepareArguments: guardBlockKitArguments as (args: unknown) => typeof blockkitSchema.static,\n    execute: async (\n      _toolCallId: string,\n      {\n        blocks,\n        text,\n        thread_ts,\n        update_ts,\n      }: {\n        blocks: unknown[];\n        text: string;\n        thread_ts?: string;\n        update_ts?: string;\n        label?: string;\n      },\n      signal?: AbortSignal,\n    ) => {\n      const ops = boundOps;\n      if (!ops) {\n        throw new Error(\"slack_blockkit is only available in Slack conversations\");\n      }\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n\n      try {\n        if (update_ts) {\n          await ops.updateBlocks({ ts: update_ts, text, blocks: blocks as object[] });\n          return {\n            content: [\n              { type: \"text\" as const, text: `Updated Block Kit message (ts: ${update_ts}).` },\n            ],\n            details: undefined,\n          };\n        }\n        const { ts } = await ops.postBlocks({\n          text,\n          blocks: blocks as object[],\n          threadTs: thread_ts,\n        });\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: `Posted Block Kit message (ts: ${ts}). Interactive elements will arrive as \"[Slack action] <action_id>: <value>\" messages; pass ts back as update_ts to edit this message.`,\n            },\n          ],\n          details: undefined,\n        };\n      } catch (err) {\n        throw formatSlackApiError(err);\n      }\n    },\n  };\n\n  return {\n    tool,\n    setSlackBlockKitOps: (ops) => {\n      boundOps = ops;\n    },\n  };\n}\n"]}

package/dist/harness/jev.d.ts

@@ -1,3 +1,4 @@
+import { type JevCaller } from "../observability/index.js";
 /** The current public Jev model id on OpenRouter. */
 export declare const JEV_MODEL_ID = "~typesafe/jev-latest";
 /**
@@ -74,6 +75,14 @@ export interface EvaluateWithJevOptions {
     model?: string;
     abortSignal?: AbortSignal;
     headers?: Record<string, string>;
+    /**
+     * Which call site is asking, so Jev spend is attributable in Sentry/OTel
+     * (`agent.jev.cost`, tagged `caller`) without any judged content leaving
+     * this function. Required rather than defaulted so a new call site must
+     * consciously pick an attribution instead of spend silently landing in a
+     * generic bucket.
+     */
+    caller: JevCaller;
 }
 /**
  * Evaluate one or more typed questions against a shared `state` using Jev,
@@ -82,5 +91,5 @@ export interface EvaluateWithJevOptions {
  * single request; batching questions here is cheap (they share the input)
  * and is preferred over separate calls per question.
  */
-export declare function evaluateWithJev<const QUESTIONS extends JevQuestions>(state: JevEntry, questions: QUESTIONS, options?: EvaluateWithJevOptions): Promise<JevResult<QUESTIONS>>;
+export declare function evaluateWithJev<const QUESTIONS extends JevQuestions>(state: JevEntry, questions: QUESTIONS, options: EvaluateWithJevOptions): Promise<JevResult<QUESTIONS>>;
 //# sourceMappingURL=jev.d.ts.map

package/dist/harness/jev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jev.d.ts","sourceRoot":"","sources":["../../src/harness/jev.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"jev.d.ts","sourceRoot":"","sources":["../../src/harness/jev.ts"],"names":[],"mappings":"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"}

package/dist/harness/jev.js

@@ -24,6 +24,7 @@
  */
 import { createBuiltinJevModels, JevAPIError, JevAuthError, JevConfigError, JevConnectionError, JevResponseError, JevTimeoutError, } from "@geminixiang/jev";
 import { readEnv } from "../env-manifest.js";
+import { recordJevOutcome } from "../observability/index.js";
 /** The current public Jev model id on OpenRouter. */
 export const JEV_MODEL_ID = "~typesafe/jev-latest";
 /** Thrown when no Jev backend has a usable credential. Callers fail closed on this. */
@@ -114,7 +115,7 @@ function fromGeminixiangAnswer(answer) {
  * single request; batching questions here is cheap (they share the input)
  * and is preferred over separate calls per question.
  */
-export async function evaluateWithJev(state, questions, options = {}) {
+export async function evaluateWithJev(state, questions, options) {
     const catalogModel = models().getModel("openrouter", "jev-latest");
     if (!catalogModel)
         throw new JevNotConfiguredError();
@@ -126,6 +127,7 @@ export async function evaluateWithJev(state, questions, options = {}) {
     for (const [id, question] of Object.entries(questions)) {
         wireQuestions[id] = toGeminixiangQuestion(question);
     }
+    const startedAt = Date.now();
     let result;
     try {
         result = await models().evaluate(model, { state: state, questions: wireQuestions }, {
@@ -134,6 +136,12 @@ export async function evaluateWithJev(state, questions, options = {}) {
         });
     }
     catch (error) {
+        recordJevOutcome({
+            caller: options.caller,
+            status: "error",
+            errorType: error instanceof Error ? error.name : "Error",
+            durationMs: Date.now() - startedAt,
+        });
         if (error instanceof JevAuthError || error instanceof JevConfigError) {
             throw new JevNotConfiguredError();
         }
@@ -147,6 +155,14 @@ export async function evaluateWithJev(state, questions, options = {}) {
         }
         throw error;
     }
+    recordJevOutcome({
+        caller: options.caller,
+        status: "ok",
+        inputTokens: result.usage.input,
+        outputTokens: result.usage.output,
+        costUsd: result.usage.cost.total,
+        durationMs: Date.now() - startedAt,
+    });
     const answers = {};
     for (const id of Object.keys(questions)) {
         const answer = result.answers[id];

package/dist/harness/jev.js.map

@@ -1 +1 @@
-{"version":3,"file":"jev.js","sourceRoot":"","sources":["../../src/harness/jev.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Jev (typesafe/jev) client, backed by `@geminixiang/jev`.\n *\n * Jev is a \"System One\" evaluation model: it scores a shared `state`\n * against typed questions (a yes/no probability, a multiple choice, or a\n * position on an ordered scale) and returns calibrated probabilities. It\n * does not generate text or tool calls, so it cannot be driven through\n * pi-ai's `Provider`/`Model`/`stream()` contract the way every model\n * `models.ts` catalogs is — that contract is chat/completion shaped\n * (system prompt + messages in, streamed text/tool-call events out), and\n * Jev's typed-decision shape does not fit it. Jev is therefore not a\n * selectable chat provider: callers import `evaluateWithJev` directly at\n * whatever call site wants a fast, cheap, type-safe decision (e.g.\n * classification, routing, guardrails), and interpret the returned\n * probabilities themselves.\n *\n * `@geminixiang/jev` owns the wire protocol, provider catalog, and auth\n * resolution for four backends (TypeSafe, OpenRouter, Vercel AI Gateway,\n * Cloudflare Workers AI); this module picks OpenRouter (the same key\n * pi-ai's `openrouter` chat provider reads) and adapts its typed\n * request/answer shapes to the caller-facing contract mikan's call sites\n * already depend on, so this file is the only one that needs to know a\n * dependency swap happened.\n */\nimport {\n  createBuiltinJevModels,\n  JevAPIError,\n  JevAuthError,\n  JevConfigError,\n  JevConnectionError,\n  JevResponseError,\n  JevTimeoutError,\n  type AnswerFor as GeminixiangAnswerFor,\n  type Entry as GeminixiangEntry,\n  type Question as GeminixiangQuestion,\n} from \"@geminixiang/jev\";\nimport type { AuthContext } from \"@earendil-works/pi-ai\";\nimport { readEnv } from \"../env-manifest.js\";\n\n/** The current public Jev model id on OpenRouter. */\nexport const JEV_MODEL_ID = \"~typesafe/jev-latest\";\n\n/**\n * Any value Jev accepts as text-bearing structure: a string, a JSON object,\n * an array, or `null`. State, instructions, and criteria descriptions all\n * take this shape; Jev is trained to read the structure, so objects with\n * labelled keys are preferred over string templates.\n */\nexport type JevEntry = string | number | boolean | null | JevEntry[] | { [key: string]: JevEntry };\n\n/** A shared caller-facing question shape; translated to `@geminixiang/jev`'s shape below. */\nexport type JevQuestion =\n  | {\n      type: \"boolean\";\n      instructions: JevEntry;\n      /** Optional descriptions of the yes / no outcomes. */\n      criteria?: { true?: JevEntry; false?: JevEntry };\n    }\n  | { type: \"choice\"; instructions: JevEntry; criteria: Record<string, JevEntry> }\n  | { type: \"score\"; instructions: JevEntry; criteria: readonly JevEntry[] };\n\nexport type JevQuestions = Record<string, JevQuestion>;\n\nexport type JevAnswer<QUESTION extends JevQuestion> = QUESTION extends { type: \"choice\" }\n  ? {\n      type: \"choice\";\n      choice: string;\n      probabilities?: Record<string, number>;\n      /** 0-1 statistic over `probabilities`; low means no option clearly fits. */\n      confidence?: number;\n    }\n  : QUESTION extends { type: \"score\" }\n    ? {\n        type: \"score\";\n        /** Expected level index; fractional between levels. */\n        score: number;\n        probabilities?: Record<string, number>;\n        /** Level index -> criterion text, as echoed by Jev. */\n        legend?: Record<string, string>;\n        confidence?: number;\n      }\n    : { type: \"boolean\"; probability: number };\n\nexport interface JevResult<QUESTIONS extends JevQuestions> {\n  readonly answers: { [ID in keyof QUESTIONS]: JevAnswer<QUESTIONS[ID]> };\n  readonly usage: {\n    inputTokens: number | undefined;\n    outputTokens: number | undefined;\n    cost: number | undefined;\n  };\n  readonly model: string;\n}\n\n/** Thrown when no Jev backend has a usable credential. Callers fail closed on this. */\nexport class JevNotConfiguredError extends Error {\n  constructor() {\n    super(\n      \"Jev requires OPENROUTER_API_KEY (an OpenRouter API key). Set it in the environment before calling evaluateWithJev().\",\n    );\n    this.name = \"JevNotConfiguredError\";\n  }\n}\n\nexport class JevRequestError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n  ) {\n    super(message);\n    this.name = \"JevRequestError\";\n  }\n}\n\nexport interface EvaluateWithJevOptions {\n  /** Evaluation model id; defaults to the current public Jev model. */\n  model?: string;\n  abortSignal?: AbortSignal;\n  headers?: Record<string, string>;\n}\n\n// ── @geminixiang/jev wiring ──────────────────────────────────────────────\n\n/**\n * Routes env reads through `readEnv` so `MIKAN_OPENROUTER_API_KEY` resolves\n * the same as every other mikan-aliased credential, instead of the\n * package's default `process.env`-only context.\n */\nconst mikanAuthContext: AuthContext = {\n  async env(name) {\n    return readEnv(name);\n  },\n  async fileExists() {\n    return false;\n  },\n};\n\nlet cachedModels: ReturnType<typeof createBuiltinJevModels> | undefined;\n\nfunction models() {\n  cachedModels ??= createBuiltinJevModels({ authContext: mikanAuthContext });\n  return cachedModels;\n}\n\nfunction toGeminixiangQuestion(question: JevQuestion): GeminixiangQuestion {\n  const instructions = question.instructions as GeminixiangEntry;\n  if (question.type === \"boolean\") {\n    // `@geminixiang/jev` leaves noul criteria optional; mikan has always sent\n    // an explicit Yes/No default so the wire payload (and anything tuned\n    // against it, e.g. the auto-reply gate) does not change under this swap.\n    return {\n      type: \"noul\",\n      instructions,\n      criteria: {\n        true: (question.criteria?.true as GeminixiangEntry) ?? \"Yes\",\n        false: (question.criteria?.false as GeminixiangEntry) ?? \"No\",\n      },\n    };\n  }\n  if (question.type === \"choice\") {\n    return {\n      type: \"choice\",\n      instructions,\n      criteria: question.criteria as Record<string, GeminixiangEntry>,\n    };\n  }\n  const [first, second, ...rest] = question.criteria as GeminixiangEntry[];\n  if (first === undefined || second === undefined) {\n    throw new Error(\"score questions need at least two levels\");\n  }\n  return { type: \"score\", instructions, criteria: [first, second, ...rest] };\n}\n\nfunction fromGeminixiangAnswer(\n  answer: GeminixiangAnswerFor<GeminixiangQuestion>,\n): JevAnswer<JevQuestion> {\n  if (answer.type === \"noul\") {\n    return { type: \"boolean\", probability: answer.noul };\n  }\n  if (answer.type === \"choice\") {\n    return {\n      type: \"choice\",\n      choice: answer.choice,\n      probabilities: answer.probabilities as Record<string, number>,\n      confidence: answer.confidence,\n    };\n  }\n  return {\n    type: \"score\",\n    score: answer.score,\n    probabilities: answer.probabilities,\n    legend: answer.legend as Record<string, string> | undefined,\n    confidence: answer.confidence,\n  };\n}\n\n/**\n * Evaluate one or more typed questions against a shared `state` using Jev,\n * reached through OpenRouter's decisions API by way of `@geminixiang/jev`.\n * Every question is scored independently against the same state in a\n * single request; batching questions here is cheap (they share the input)\n * and is preferred over separate calls per question.\n */\nexport async function evaluateWithJev<const QUESTIONS extends JevQuestions>(\n  state: JevEntry,\n  questions: QUESTIONS,\n  options: EvaluateWithJevOptions = {},\n): Promise<JevResult<QUESTIONS>> {\n  const catalogModel = models().getModel(\"openrouter\", \"jev-latest\");\n  if (!catalogModel) throw new JevNotConfiguredError();\n  // `options.model` is the wire model id callers already pass (e.g. from\n  // JEV_MODEL_ID); override the catalog slug directly rather than adding a\n  // second catalog entry per possible override.\n  const model = options.model ? { ...catalogModel, slug: options.model } : catalogModel;\n\n  const wireQuestions: Record<string, GeminixiangQuestion> = {};\n  for (const [id, question] of Object.entries(questions)) {\n    wireQuestions[id] = toGeminixiangQuestion(question);\n  }\n\n  let result;\n  try {\n    result = await models().evaluate(\n      model,\n      { state: state as GeminixiangEntry, questions: wireQuestions },\n      {\n        ...(options.headers ? { headers: options.headers } : {}),\n        ...(options.abortSignal ? { signal: options.abortSignal } : {}),\n      },\n    );\n  } catch (error) {\n    if (error instanceof JevAuthError || error instanceof JevConfigError) {\n      throw new JevNotConfiguredError();\n    }\n    if (error instanceof JevAPIError) {\n      throw new JevRequestError(error.message, error.status);\n    }\n    if (\n      error instanceof JevResponseError ||\n      error instanceof JevConnectionError ||\n      error instanceof JevTimeoutError\n    ) {\n      throw new JevRequestError(error.message, 502);\n    }\n    throw error;\n  }\n\n  const answers = {} as { [ID in keyof QUESTIONS]: JevAnswer<QUESTIONS[ID]> };\n  for (const id of Object.keys(questions)) {\n    const answer = result.answers[id];\n    if (!answer) throw new JevRequestError(`Jev response missing answer for \"${id}\"`, 502);\n    (answers as Record<string, JevAnswer<JevQuestion>>)[id] = fromGeminixiangAnswer(answer);\n  }\n\n  return {\n    answers,\n    usage: {\n      inputTokens: result.usage.input,\n      outputTokens: result.usage.output,\n      cost: result.usage.cost.total,\n    },\n    model: result.model,\n  };\n}\n"]}
+{"version":3,"file":"jev.js","sourceRoot":"","sources":["../../src/harness/jev.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Jev (typesafe/jev) client, backed by `@geminixiang/jev`.\n *\n * Jev is a \"System One\" evaluation model: it scores a shared `state`\n * against typed questions (a yes/no probability, a multiple choice, or a\n * position on an ordered scale) and returns calibrated probabilities. It\n * does not generate text or tool calls, so it cannot be driven through\n * pi-ai's `Provider`/`Model`/`stream()` contract the way every model\n * `models.ts` catalogs is — that contract is chat/completion shaped\n * (system prompt + messages in, streamed text/tool-call events out), and\n * Jev's typed-decision shape does not fit it. Jev is therefore not a\n * selectable chat provider: callers import `evaluateWithJev` directly at\n * whatever call site wants a fast, cheap, type-safe decision (e.g.\n * classification, routing, guardrails), and interpret the returned\n * probabilities themselves.\n *\n * `@geminixiang/jev` owns the wire protocol, provider catalog, and auth\n * resolution for four backends (TypeSafe, OpenRouter, Vercel AI Gateway,\n * Cloudflare Workers AI); this module picks OpenRouter (the same key\n * pi-ai's `openrouter` chat provider reads) and adapts its typed\n * request/answer shapes to the caller-facing contract mikan's call sites\n * already depend on, so this file is the only one that needs to know a\n * dependency swap happened.\n */\nimport {\n  createBuiltinJevModels,\n  JevAPIError,\n  JevAuthError,\n  JevConfigError,\n  JevConnectionError,\n  JevResponseError,\n  JevTimeoutError,\n  type AnswerFor as GeminixiangAnswerFor,\n  type Entry as GeminixiangEntry,\n  type Question as GeminixiangQuestion,\n} from \"@geminixiang/jev\";\nimport type { AuthContext } from \"@earendil-works/pi-ai\";\nimport { readEnv } from \"../env-manifest.js\";\nimport { recordJevOutcome, type JevCaller } from \"../observability/index.js\";\n\n/** The current public Jev model id on OpenRouter. */\nexport const JEV_MODEL_ID = \"~typesafe/jev-latest\";\n\n/**\n * Any value Jev accepts as text-bearing structure: a string, a JSON object,\n * an array, or `null`. State, instructions, and criteria descriptions all\n * take this shape; Jev is trained to read the structure, so objects with\n * labelled keys are preferred over string templates.\n */\nexport type JevEntry = string | number | boolean | null | JevEntry[] | { [key: string]: JevEntry };\n\n/** A shared caller-facing question shape; translated to `@geminixiang/jev`'s shape below. */\nexport type JevQuestion =\n  | {\n      type: \"boolean\";\n      instructions: JevEntry;\n      /** Optional descriptions of the yes / no outcomes. */\n      criteria?: { true?: JevEntry; false?: JevEntry };\n    }\n  | { type: \"choice\"; instructions: JevEntry; criteria: Record<string, JevEntry> }\n  | { type: \"score\"; instructions: JevEntry; criteria: readonly JevEntry[] };\n\nexport type JevQuestions = Record<string, JevQuestion>;\n\nexport type JevAnswer<QUESTION extends JevQuestion> = QUESTION extends { type: \"choice\" }\n  ? {\n      type: \"choice\";\n      choice: string;\n      probabilities?: Record<string, number>;\n      /** 0-1 statistic over `probabilities`; low means no option clearly fits. */\n      confidence?: number;\n    }\n  : QUESTION extends { type: \"score\" }\n    ? {\n        type: \"score\";\n        /** Expected level index; fractional between levels. */\n        score: number;\n        probabilities?: Record<string, number>;\n        /** Level index -> criterion text, as echoed by Jev. */\n        legend?: Record<string, string>;\n        confidence?: number;\n      }\n    : { type: \"boolean\"; probability: number };\n\nexport interface JevResult<QUESTIONS extends JevQuestions> {\n  readonly answers: { [ID in keyof QUESTIONS]: JevAnswer<QUESTIONS[ID]> };\n  readonly usage: {\n    inputTokens: number | undefined;\n    outputTokens: number | undefined;\n    cost: number | undefined;\n  };\n  readonly model: string;\n}\n\n/** Thrown when no Jev backend has a usable credential. Callers fail closed on this. */\nexport class JevNotConfiguredError extends Error {\n  constructor() {\n    super(\n      \"Jev requires OPENROUTER_API_KEY (an OpenRouter API key). Set it in the environment before calling evaluateWithJev().\",\n    );\n    this.name = \"JevNotConfiguredError\";\n  }\n}\n\nexport class JevRequestError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n  ) {\n    super(message);\n    this.name = \"JevRequestError\";\n  }\n}\n\nexport interface EvaluateWithJevOptions {\n  /** Evaluation model id; defaults to the current public Jev model. */\n  model?: string;\n  abortSignal?: AbortSignal;\n  headers?: Record<string, string>;\n  /**\n   * Which call site is asking, so Jev spend is attributable in Sentry/OTel\n   * (`agent.jev.cost`, tagged `caller`) without any judged content leaving\n   * this function. Required rather than defaulted so a new call site must\n   * consciously pick an attribution instead of spend silently landing in a\n   * generic bucket.\n   */\n  caller: JevCaller;\n}\n\n// ── @geminixiang/jev wiring ──────────────────────────────────────────────\n\n/**\n * Routes env reads through `readEnv` so `MIKAN_OPENROUTER_API_KEY` resolves\n * the same as every other mikan-aliased credential, instead of the\n * package's default `process.env`-only context.\n */\nconst mikanAuthContext: AuthContext = {\n  async env(name) {\n    return readEnv(name);\n  },\n  async fileExists() {\n    return false;\n  },\n};\n\nlet cachedModels: ReturnType<typeof createBuiltinJevModels> | undefined;\n\nfunction models() {\n  cachedModels ??= createBuiltinJevModels({ authContext: mikanAuthContext });\n  return cachedModels;\n}\n\nfunction toGeminixiangQuestion(question: JevQuestion): GeminixiangQuestion {\n  const instructions = question.instructions as GeminixiangEntry;\n  if (question.type === \"boolean\") {\n    // `@geminixiang/jev` leaves noul criteria optional; mikan has always sent\n    // an explicit Yes/No default so the wire payload (and anything tuned\n    // against it, e.g. the auto-reply gate) does not change under this swap.\n    return {\n      type: \"noul\",\n      instructions,\n      criteria: {\n        true: (question.criteria?.true as GeminixiangEntry) ?? \"Yes\",\n        false: (question.criteria?.false as GeminixiangEntry) ?? \"No\",\n      },\n    };\n  }\n  if (question.type === \"choice\") {\n    return {\n      type: \"choice\",\n      instructions,\n      criteria: question.criteria as Record<string, GeminixiangEntry>,\n    };\n  }\n  const [first, second, ...rest] = question.criteria as GeminixiangEntry[];\n  if (first === undefined || second === undefined) {\n    throw new Error(\"score questions need at least two levels\");\n  }\n  return { type: \"score\", instructions, criteria: [first, second, ...rest] };\n}\n\nfunction fromGeminixiangAnswer(\n  answer: GeminixiangAnswerFor<GeminixiangQuestion>,\n): JevAnswer<JevQuestion> {\n  if (answer.type === \"noul\") {\n    return { type: \"boolean\", probability: answer.noul };\n  }\n  if (answer.type === \"choice\") {\n    return {\n      type: \"choice\",\n      choice: answer.choice,\n      probabilities: answer.probabilities as Record<string, number>,\n      confidence: answer.confidence,\n    };\n  }\n  return {\n    type: \"score\",\n    score: answer.score,\n    probabilities: answer.probabilities,\n    legend: answer.legend as Record<string, string> | undefined,\n    confidence: answer.confidence,\n  };\n}\n\n/**\n * Evaluate one or more typed questions against a shared `state` using Jev,\n * reached through OpenRouter's decisions API by way of `@geminixiang/jev`.\n * Every question is scored independently against the same state in a\n * single request; batching questions here is cheap (they share the input)\n * and is preferred over separate calls per question.\n */\nexport async function evaluateWithJev<const QUESTIONS extends JevQuestions>(\n  state: JevEntry,\n  questions: QUESTIONS,\n  options: EvaluateWithJevOptions,\n): Promise<JevResult<QUESTIONS>> {\n  const catalogModel = models().getModel(\"openrouter\", \"jev-latest\");\n  if (!catalogModel) throw new JevNotConfiguredError();\n  // `options.model` is the wire model id callers already pass (e.g. from\n  // JEV_MODEL_ID); override the catalog slug directly rather than adding a\n  // second catalog entry per possible override.\n  const model = options.model ? { ...catalogModel, slug: options.model } : catalogModel;\n\n  const wireQuestions: Record<string, GeminixiangQuestion> = {};\n  for (const [id, question] of Object.entries(questions)) {\n    wireQuestions[id] = toGeminixiangQuestion(question);\n  }\n\n  const startedAt = Date.now();\n  let result;\n  try {\n    result = await models().evaluate(\n      model,\n      { state: state as GeminixiangEntry, questions: wireQuestions },\n      {\n        ...(options.headers ? { headers: options.headers } : {}),\n        ...(options.abortSignal ? { signal: options.abortSignal } : {}),\n      },\n    );\n  } catch (error) {\n    recordJevOutcome({\n      caller: options.caller,\n      status: \"error\",\n      errorType: error instanceof Error ? error.name : \"Error\",\n      durationMs: Date.now() - startedAt,\n    });\n    if (error instanceof JevAuthError || error instanceof JevConfigError) {\n      throw new JevNotConfiguredError();\n    }\n    if (error instanceof JevAPIError) {\n      throw new JevRequestError(error.message, error.status);\n    }\n    if (\n      error instanceof JevResponseError ||\n      error instanceof JevConnectionError ||\n      error instanceof JevTimeoutError\n    ) {\n      throw new JevRequestError(error.message, 502);\n    }\n    throw error;\n  }\n  recordJevOutcome({\n    caller: options.caller,\n    status: \"ok\",\n    inputTokens: result.usage.input,\n    outputTokens: result.usage.output,\n    costUsd: result.usage.cost.total,\n    durationMs: Date.now() - startedAt,\n  });\n\n  const answers = {} as { [ID in keyof QUESTIONS]: JevAnswer<QUESTIONS[ID]> };\n  for (const id of Object.keys(questions)) {\n    const answer = result.answers[id];\n    if (!answer) throw new JevRequestError(`Jev response missing answer for \"${id}\"`, 502);\n    (answers as Record<string, JevAnswer<JevQuestion>>)[id] = fromGeminixiangAnswer(answer);\n  }\n\n  return {\n    answers,\n    usage: {\n      inputTokens: result.usage.input,\n      outputTokens: result.usage.output,\n      cost: result.usage.cost.total,\n    },\n    model: result.model,\n  };\n}\n"]}

package/dist/harness/presenter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presenter.d.ts","sourceRoot":"","sources":["../../src/harness/presenter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,GAAG,EAAE,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAEV,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAOtD,OAAO,KAAK,EAAE,qBAAqB,EAA4B,MAAM,aAAa,CAAC;AACnF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AA+DxE,wBAAgB,cAAc,IAAI,kBAAkB,CAkCnD;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE;IACP,SAAS,EAAE,qBAAqB,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC,GACA,eAAe,CAsEjB;AAOD,wBAAgB,yBAAyB,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEzF;AAqKD,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,qBAAqB,EAChC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE;IACR,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CAAC,IAAI,CAAC,CAsBf;AAsFD,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiG/E;AAucD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,WAAW,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;CAC7D,GAAG,IAAI,CAiBP"}
+{"version":3,"file":"presenter.d.ts","sourceRoot":"","sources":["../../src/harness/presenter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,GAAG,EAAE,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAEV,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAOtD,OAAO,KAAK,EAAE,qBAAqB,EAA4B,MAAM,aAAa,CAAC;AACnF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AA+DxE,wBAAgB,cAAc,IAAI,kBAAkB,CAkCnD;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE;IACP,SAAS,EAAE,qBAAqB,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC,GACA,eAAe,CAsEjB;AAOD,wBAAgB,yBAAyB,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEzF;AA0KD,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,qBAAqB,EAChC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE;IACR,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CAAC,IAAI,CAAC,CAsBf;AAsFD,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiG/E;AAucD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,WAAW,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;CAC7D,GAAG,IAAI,CAiBP"}

package/dist/harness/presenter.js

@@ -157,9 +157,14 @@ export function isEventTriggerAttribution(triggerAttribution) {
 function extractToolLabel(toolName, args) {
     const label = args?.label;
     const text = typeof label === "string" ? label.trim() || toolName : toolName;
-    // Jev judgments are calibrated probabilities, not the model's own guess;
-    // name the tool so the user can tell which steps came from it.
-    return toolName === "jev" ? `jev · ${text}` : text;
+    // Jev judgments are calibrated probabilities, not the model's own guess,
+    // and jev_browser drives a real external browser; name the tool so the
+    // user can tell which steps came from either. Guard against doubling the
+    // name when no real label was supplied and text fell back to toolName.
+    if ((toolName === "jev" || toolName === "jev_browser") && text !== toolName) {
+        return `${toolName} · ${text}`;
+    }
+    return text;
 }
 /** Non-subagent tool activity lines; subagent calls render as the dashboard. */
 function formatToolProgress(runState) {