@oh-my-pi/pi-coding-agent 14.5.12 → 14.5.13

package/src/eval/backend.ts

@@ -0,0 +1,43 @@
+import type { ToolSession } from "../tools";
+import type { EvalDisplayOutput, EvalLanguage } from "./types";
+
+/** Per-cell execute() options. */
+export interface ExecutorBackendExecOptions {
+	cwd: string;
+	sessionId: string;
+	sessionFile: string | undefined;
+	kernelOwnerId: string | undefined;
+	signal?: AbortSignal;
+	session: ToolSession;
+	deadlineMs: number;
+	reset: boolean;
+	artifactPath: string | undefined;
+	artifactId: string | undefined;
+	onChunk: (chunk: string) => void;
+}
+
+/** Result returned by a backend's execute(). */
+export interface ExecutorBackendResult {
+	output: string;
+	exitCode: number | undefined;
+	cancelled: boolean;
+	truncated: boolean;
+	artifactId: string | undefined;
+	totalLines: number;
+	totalBytes: number;
+	outputLines: number;
+	outputBytes: number;
+	displayOutputs: EvalDisplayOutput[];
+}
+
+/** Pluggable language backend for the eval tool. */
+export interface ExecutorBackend {
+	readonly id: EvalLanguage;
+	readonly label: string;
+	/** Source language identifier passed to the syntax highlighter (e.g. "python", "javascript"). */
+	readonly highlightLang: string;
+	/** Cheap availability check. Used by fallback resolution. */
+	isAvailable(session: ToolSession): Promise<boolean>;
+	/** Execute one cell. Caller invokes once per cell and aggregates results. */
+	execute(code: string, opts: ExecutorBackendExecOptions): Promise<ExecutorBackendResult>;
+}

package/src/eval/eval.lark

@@ -0,0 +1,43 @@
+%import common.LF
+%import common.WS_INLINE
+
+// Strict canonical surface for the eval tool. Callers MUST emit exactly this
+// form. The runtime parser accepts additional lenient shapes (positional
+// title/duration, alias keys, long-form lang tokens, mixed casing, fence
+// runs of any length ≥ 3, etc.) but those are fallback only and MUST NOT
+// be relied on.
+//
+// Each cell is a fenced code block opened and closed by exactly three
+// (or exactly five) backticks or tildes — five lets callers nest a 3-char
+// fence inside a cell verbatim. The opening fence carries an optional info
+// string with up to four parts, IN THIS ORDER:
+//
+//   lang?  id_attr?  t_attr?  rst_attr?
+//
+// where:
+//   lang    = "py" | "js" | "ts"
+//   id_attr = id="..."        (double-quoted cell id)
+//   t_attr  = t=<duration>    (bare integer with optional ms/s/m unit)
+//   rst_attr= rst=0|1         (per-language kernel reset for this cell)
+
+start: cell+
+
+cell: backtick_cell | tilde_cell
+
+backtick_cell: BACKTICKS info? LF code_line* BACKTICKS LF
+tilde_cell:    TILDES   info? LF code_line* TILDES   LF
+
+info: lang (WS_INLINE id_attr)? (WS_INLINE t_attr)? (WS_INLINE rst_attr)?
+    | id_attr (WS_INLINE t_attr)? (WS_INLINE rst_attr)?
+    | t_attr (WS_INLINE rst_attr)?
+    | rst_attr
+
+lang:     "py" | "js" | "ts"
+id_attr:  "id="  /"[^"\r\n]*"/
+t_attr:   "t="   /\d+(ms|s|m)?/
+rst_attr: "rst=" /[01]/
+
+code_line: /[^\r\n]*/ LF
+
+BACKTICKS: "```"   | "`````"
+TILDES:    "~~~"   | "~~~~~"

package/src/eval/index.ts

@@ -0,0 +1,5 @@
+export * from "./backend";
+export { default as jsBackend } from "./js";
+export * from "./parse";
+export { default as pythonBackend } from "./py";
+export * from "./types";