@code-yeongyu/senpi-codemode 2026.7.25-2

package/src/tool/status-events.ts

@@ -0,0 +1,12 @@
+import type { EvalStatusEvent } from "./types.ts";
+
+export function upsertStatusEvent(events: EvalStatusEvent[], event: EvalStatusEvent): void {
+	if (event.op === "agent" && typeof event.id === "string") {
+		const index = events.findIndex((candidate) => candidate.op === "agent" && candidate.id === event.id);
+		if (index >= 0) {
+			events[index] = event;
+			return;
+		}
+	}
+	events.push(event);
+}

package/src/tool/types.ts

@@ -0,0 +1,114 @@
+import type { AgentToolResult, AgentToolUpdateCallback } from "@code-yeongyu/senpi";
+import { Type } from "typebox";
+import type { HostToKernelMessage, KernelToHostMessage } from "../bridge/protocol.ts";
+import type { TruncationMeta } from "../output/output-meta.ts";
+
+export const evalLanguageOrder = ["py", "js", "rb", "jl"] as const;
+export type EvalLanguage = (typeof evalLanguageOrder)[number];
+export type EnabledEvalLanguages = Readonly<Record<EvalLanguage, boolean>>;
+
+export function enabledLanguageList(enabled: EnabledEvalLanguages): EvalLanguage[] {
+	return evalLanguageOrder.filter((language) => enabled[language]);
+}
+
+const fullEvalInputSchema = Type.Object({
+	language: Type.Union([Type.Literal("py"), Type.Literal("js"), Type.Literal("rb"), Type.Literal("jl")]),
+	code: Type.String({ description: "Cell body, verbatim." }),
+	title: Type.Optional(Type.String({ description: "Short transcript label." })),
+	timeout: Type.Optional(Type.Number({ minimum: 1, description: "Timeout in seconds." })),
+	reset: Type.Optional(Type.Boolean({ description: "Reset this language kernel before running." })),
+});
+
+export function createEvalInputSchema(enabled: EnabledEvalLanguages): typeof fullEvalInputSchema {
+	const languages = enabledLanguageList(enabled);
+	if (languages.length === 0) throw new Error("eval requires at least one enabled language");
+	const languageSchema =
+		languages.length === 1
+			? Type.Union([Type.Literal(languages[0])])
+			: Type.Union(languages.map((item) => Type.Literal(item)));
+	return Type.Object({
+		language: languageSchema,
+		code: Type.String({ description: "Cell body, verbatim." }),
+		title: Type.Optional(Type.String({ description: "Short transcript label." })),
+		timeout: Type.Optional(Type.Number({ minimum: 1, description: "Timeout in seconds." })),
+		reset: Type.Optional(Type.Boolean({ description: "Reset this language kernel before running." })),
+	}) as typeof fullEvalInputSchema;
+}
+
+export type EvalInputSchema = typeof fullEvalInputSchema;
+export interface EvalToolInput {
+	readonly language: EvalLanguage;
+	readonly code: string;
+	readonly title?: string;
+	readonly timeout?: number;
+	readonly reset?: boolean;
+}
+export type EvalKernelResult = Extract<KernelToHostMessage, { type: "result" }>;
+export type EvalToolCallMessage = Extract<KernelToHostMessage, { type: "tool-call" }>;
+
+export interface EvalKernelRunInput {
+	readonly cellId: string;
+	readonly code: string;
+	readonly timeoutMs?: number;
+}
+
+export interface EvalKernel {
+	run(input: EvalKernelRunInput): Promise<EvalKernelResult>;
+	interrupt(reason?: string): Promise<void>;
+	deliverToolReply(message: Extract<HostToKernelMessage, { type: "tool-reply" }>): void;
+	reset(): Promise<void>;
+	close(): Promise<void>;
+}
+
+export interface EvalKernelManager {
+	getKernel(language: EvalLanguage, onMessage: (message: KernelToHostMessage) => void): Promise<EvalKernel>;
+}
+
+export type ExecuteTool = (
+	toolName: string,
+	params: unknown,
+	options?: { signal?: AbortSignal; onUpdate?: AgentToolUpdateCallback<unknown> },
+) => Promise<AgentToolResult<unknown>>;
+
+export interface EvalToolCallSummary {
+	readonly name: string;
+	readonly ok: boolean;
+	readonly error?: string;
+}
+
+export type EvalStatusEvent = { readonly op: string } & Readonly<Record<string, unknown>>;
+
+export type EvalDisplayOutput =
+	| { readonly type: "json"; readonly data: unknown }
+	| { readonly type: "image"; readonly data: string; readonly mimeType: string }
+	| { readonly type: "markdown"; readonly text: string }
+	| { readonly type: "status"; readonly event: EvalStatusEvent };
+
+export type EvalCellResult = {
+	readonly index: number;
+	readonly title?: string;
+	readonly code: string;
+	readonly language: EvalLanguage;
+	readonly output: string;
+	readonly status: "pending" | "running" | "complete" | "error";
+	readonly exitCode?: number;
+	readonly durationMs?: number;
+	readonly statusEvents?: readonly EvalStatusEvent[];
+	readonly hasMarkdown?: boolean;
+};
+
+export interface EvalToolDetails {
+	readonly language: EvalLanguage;
+	readonly languages?: readonly EvalLanguage[];
+	readonly title?: string;
+	readonly durationMs: number;
+	readonly toolCalls: readonly EvalToolCallSummary[];
+	readonly truncated: boolean;
+	readonly isError?: boolean;
+	readonly phase?: string;
+	readonly cells?: readonly EvalCellResult[];
+	readonly statusEvents?: readonly EvalStatusEvent[];
+	readonly jsonOutputs?: readonly unknown[];
+	readonly notice?: string;
+	readonly meta?: TruncationMeta;
+}