@geminixiang/mikan 1.0.0-beta.9 → 1.0.0-beta.91

package/dist/harness/tools/event.js

@@ -0,0 +1,183 @@
+import { Type } from "typebox";
+import { buildEventPayload, EventTypeSchema, upcomingRuns, validateEventFilename, } from "../../events/index.js";
+import * as log from "../../log.js";
+const eventSchema = Type.Object({
+    action: Type.Optional(Type.Union([
+        Type.Literal("create"),
+        Type.Literal("list"),
+        Type.Literal("read"),
+        Type.Literal("update"),
+        Type.Literal("delete"),
+    ], { description: "CRUD action. Defaults to create for backward compatibility." })),
+    filename: Type.Optional(Type.String({
+        description: "Event filename for read, update, or delete actions",
+    })),
+    scope: Type.Optional(Type.Literal("conversation", {
+        description: "Only events owned by the current office are accessible.",
+    })),
+    label: Type.Optional(Type.String({
+        description: "Brief description of the event you're scheduling (shown to user)",
+    })),
+    type: Type.Optional(EventTypeSchema),
+    text: Type.Optional(Type.String({
+        description: "A self-contained task for the future run. Include the necessary context, tone, and constraints in the text itself because events do not inherit normal conversation history.",
+    })),
+    at: Type.Optional(Type.String({
+        description: "ISO 8601 timestamp with offset, required for one-shot events",
+    })),
+    schedule: Type.Optional(Type.String({
+        description: "Cron schedule, required for periodic events",
+    })),
+    timezone: Type.Optional(Type.String({
+        description: "IANA timezone, required for periodic events",
+    })),
+    filenamePrefix: Type.Optional(Type.String({
+        description: "Optional filename prefix for the event file",
+    })),
+});
+function textResult(text) {
+    return { content: [{ type: "text", text }], details: undefined };
+}
+const WRITE_VERBS = {
+    create: { present: "Writing", past: "Wrote", infinitive: "write" },
+    update: { present: "Updating", past: "Updated", infinitive: "update" },
+};
+export function createEventTool(eventStore) {
+    let eventContext = null;
+    const tool = {
+        name: "event",
+        label: "event",
+        description: "CRUD tool for scheduled events owned by the current office. Other offices' events cannot be listed, read, changed, or deleted. Event text must be self-contained because events do not inherit normal conversation history.",
+        parameters: eventSchema,
+        execute: async (_toolCallId, params, signal) => {
+            if (signal?.aborted) {
+                throw new Error("Operation aborted");
+            }
+            if (!eventContext) {
+                throw new Error("Event context not configured");
+            }
+            return runEventAction(eventStore, params, eventContext);
+        },
+    };
+    return {
+        tool,
+        setEventContext: (context) => {
+            eventContext = context;
+        },
+    };
+}
+async function runEventAction(eventStore, params, context) {
+    const action = params.action ?? "create";
+    if (params.scope !== undefined && params.scope !== "conversation") {
+        throw new Error("Cross-office event access is not authorized");
+    }
+    if (action === "list")
+        return listEvents(eventStore, context);
+    if (action === "read") {
+        const event = await eventStore.read(requireFilename(params));
+        return textResult(JSON.stringify(event, null, 2));
+    }
+    if (action === "delete") {
+        const filename = requireFilename(params);
+        await eventStore.delete(filename);
+        return textResult(`Deleted event ${filename}`);
+    }
+    return writeEvent(eventStore, action, params, context);
+}
+async function listEvents(eventStore, context) {
+    const events = await eventStore.list();
+    return textResult(JSON.stringify({ scope: "conversation", conversationId: context.conversationId, events }, null, 2));
+}
+async function writeEvent(eventStore, action, params, context) {
+    const payload = buildToolEventPayload(params, context);
+    if (eventStore.address.platform !== context.platform ||
+        eventStore.address.conversationId !== context.conversationId) {
+        throw new Error("Event context does not match the current office");
+    }
+    const filename = action === "update"
+        ? requireFilename(params)
+        : `${sanitizeFileSegment(params.filenamePrefix || payload.type || "event")}-${Date.now()}.json`;
+    const verbs = WRITE_VERBS[action];
+    log.logInfo(`${verbs.present} event file via control plane store: ${filename} (type=${payload.type}, platform=${payload.platform}, conversation=${payload.conversationId})`);
+    try {
+        const result = action === "update"
+            ? await eventStore.update(filename, payload)
+            : await eventStore.create(filename, payload);
+        log.logInfo(`${verbs.past} event file via control plane store: ${result.path} (${result.size} bytes)`);
+    }
+    catch (err) {
+        log.logWarning(`Failed to ${verbs.infinitive} event file via control plane store: ${filename}`, String(err));
+        throw err;
+    }
+    return textResult(formatEventWriteResult(action, filename, payload));
+}
+function buildToolEventPayload(params, context) {
+    if (!params.type) {
+        throw new Error("`type` is required for create and update actions");
+    }
+    if (!params.text) {
+        throw new Error("`text` is required for create and update actions");
+    }
+    const payload = buildEventPayload({
+        type: params.type,
+        platform: context.platform,
+        conversationId: context.conversationId,
+        conversationKind: context.conversationKind,
+        userId: context.userId,
+        text: params.text,
+        at: params.at,
+        schedule: params.schedule,
+        timezone: params.timezone,
+    });
+    if (payload.type === "one-shot" && new Date(payload.at).getTime() <= Date.now()) {
+        throw new Error(`\`at\` must be in the future; got ${payload.at} (now=${new Date().toISOString()}). Check the timezone offset.`);
+    }
+    return payload;
+}
+function formatEventWriteResult(action, filename, payload) {
+    const scheduledVerb = action === "update" ? "Updated" : "Scheduled";
+    const immediateVerb = action === "update" ? "Updated" : "Queued";
+    const target = payload.platform
+        ? `${payload.platform}/${payload.conversationId}`
+        : payload.conversationId;
+    switch (payload.type) {
+        case "periodic":
+            return `${scheduledVerb} periodic event ${filename} for ${target} (${payload.schedule} ${payload.timezone}). ${formatUpcomingRuns(payload.schedule, payload.timezone)}`;
+        case "one-shot":
+            return `${scheduledVerb} one-shot event ${filename} for ${target} at ${payload.at}`;
+        case "immediate":
+            return `${immediateVerb} immediate event ${filename} for ${target}`;
+    }
+}
+function formatUpcomingRuns(schedule, timezone) {
+    const format = new Intl.DateTimeFormat("en-CA", {
+        timeZone: timezone,
+        weekday: "short",
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        hourCycle: "h23",
+    });
+    const runs = upcomingRuns(schedule, timezone, 3).map((run) => {
+        const part = (type) => format.formatToParts(run).find((p) => p.type === type)?.value;
+        return `${part("weekday")} ${part("year")}-${part("month")}-${part("day")} ${part("hour")}:${part("minute")}`;
+    });
+    return `Next runs: ${runs.join(", ")} (${timezone})`;
+}
+function requireFilename(params) {
+    if (!params.filename) {
+        throw new Error("`filename` is required for read, update, and delete actions");
+    }
+    return validateEventFilename(params.filename);
+}
+function sanitizeFileSegment(value) {
+    const sanitized = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return sanitized || "event";
+}
+//# sourceMappingURL=event.js.map

package/dist/harness/tools/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/harness/tools/event.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { type Static, Type } from \"typebox\";\nimport type { ConversationKind } from \"../../types.js\";\nimport {\n  buildEventPayload,\n  EventTypeSchema,\n  upcomingRuns,\n  validateEventFilename,\n} from \"../../events/index.js\";\nimport type { EventPayload, EventStore } from \"../../events/index.js\";\nimport * as log from \"../../log.js\";\n\nconst eventSchema = Type.Object({\n  action: Type.Optional(\n    Type.Union(\n      [\n        Type.Literal(\"create\"),\n        Type.Literal(\"list\"),\n        Type.Literal(\"read\"),\n        Type.Literal(\"update\"),\n        Type.Literal(\"delete\"),\n      ],\n      { description: \"CRUD action. Defaults to create for backward compatibility.\" },\n    ),\n  ),\n  filename: Type.Optional(\n    Type.String({\n      description: \"Event filename for read, update, or delete actions\",\n    }),\n  ),\n  scope: Type.Optional(\n    Type.Literal(\"conversation\", {\n      description: \"Only events owned by the current office are accessible.\",\n    }),\n  ),\n  label: Type.Optional(\n    Type.String({\n      description: \"Brief description of the event you're scheduling (shown to user)\",\n    }),\n  ),\n  type: Type.Optional(EventTypeSchema),\n  text: Type.Optional(\n    Type.String({\n      description:\n        \"A self-contained task for the future run. Include the necessary context, tone, and constraints in the text itself because events do not inherit normal conversation history.\",\n    }),\n  ),\n  at: Type.Optional(\n    Type.String({\n      description: \"ISO 8601 timestamp with offset, required for one-shot events\",\n    }),\n  ),\n  schedule: Type.Optional(\n    Type.String({\n      description: \"Cron schedule, required for periodic events\",\n    }),\n  ),\n  timezone: Type.Optional(\n    Type.String({\n      description: \"IANA timezone, required for periodic events\",\n    }),\n  ),\n  filenamePrefix: Type.Optional(\n    Type.String({\n      description: \"Optional filename prefix for the event file\",\n    }),\n  ),\n});\n\ninterface EventToolContext {\n  platform: string;\n  conversationId: string;\n  conversationKind: ConversationKind;\n  userId: string;\n}\n\ntype EventToolParams = Static<typeof eventSchema>;\n\ntype EventToolResult = Awaited<ReturnType<AgentTool<typeof eventSchema>[\"execute\"]>>;\n\nfunction textResult(text: string): EventToolResult {\n  return { content: [{ type: \"text\", text }], details: undefined };\n}\n\nconst WRITE_VERBS = {\n  create: { present: \"Writing\", past: \"Wrote\", infinitive: \"write\" },\n  update: { present: \"Updating\", past: \"Updated\", infinitive: \"update\" },\n} as const;\n\nexport function createEventTool(eventStore: EventStore): {\n  tool: AgentTool<typeof eventSchema>;\n  setEventContext: (context: EventToolContext) => void;\n} {\n  let eventContext: EventToolContext | null = null;\n\n  const tool: AgentTool<typeof eventSchema> = {\n    name: \"event\",\n    label: \"event\",\n    description:\n      \"CRUD tool for scheduled events owned by the current office. Other offices' events cannot be listed, read, changed, or deleted. Event text must be self-contained because events do not inherit normal conversation history.\",\n    parameters: eventSchema,\n    execute: async (_toolCallId: string, params: EventToolParams, signal?: AbortSignal) => {\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n      if (!eventContext) {\n        throw new Error(\"Event context not configured\");\n      }\n      return runEventAction(eventStore, params, eventContext);\n    },\n  };\n\n  return {\n    tool,\n    setEventContext: (context: EventToolContext) => {\n      eventContext = context;\n    },\n  };\n}\n\nasync function runEventAction(\n  eventStore: EventStore,\n  params: EventToolParams,\n  context: EventToolContext,\n): Promise<EventToolResult> {\n  const action = params.action ?? \"create\";\n  if (params.scope !== undefined && params.scope !== \"conversation\") {\n    throw new Error(\"Cross-office event access is not authorized\");\n  }\n  if (action === \"list\") return listEvents(eventStore, context);\n  if (action === \"read\") {\n    const event = await eventStore.read(requireFilename(params));\n    return textResult(JSON.stringify(event, null, 2));\n  }\n  if (action === \"delete\") {\n    const filename = requireFilename(params);\n    await eventStore.delete(filename);\n    return textResult(`Deleted event ${filename}`);\n  }\n  return writeEvent(eventStore, action, params, context);\n}\n\nasync function listEvents(\n  eventStore: EventStore,\n  context: EventToolContext,\n): Promise<EventToolResult> {\n  const events = await eventStore.list();\n  return textResult(\n    JSON.stringify(\n      { scope: \"conversation\", conversationId: context.conversationId, events },\n      null,\n      2,\n    ),\n  );\n}\n\nasync function writeEvent(\n  eventStore: EventStore,\n  action: \"create\" | \"update\",\n  params: EventToolParams,\n  context: EventToolContext,\n): Promise<EventToolResult> {\n  const payload = buildToolEventPayload(params, context);\n  if (\n    eventStore.address.platform !== context.platform ||\n    eventStore.address.conversationId !== context.conversationId\n  ) {\n    throw new Error(\"Event context does not match the current office\");\n  }\n  const filename =\n    action === \"update\"\n      ? requireFilename(params)\n      : `${sanitizeFileSegment(params.filenamePrefix || payload.type || \"event\")}-${Date.now()}.json`;\n  const verbs = WRITE_VERBS[action];\n\n  log.logInfo(\n    `${verbs.present} event file via control plane store: ${filename} (type=${payload.type}, platform=${payload.platform}, conversation=${payload.conversationId})`,\n  );\n\n  try {\n    const result =\n      action === \"update\"\n        ? await eventStore.update(filename, payload)\n        : await eventStore.create(filename, payload);\n    log.logInfo(\n      `${verbs.past} event file via control plane store: ${result.path} (${result.size} bytes)`,\n    );\n  } catch (err) {\n    log.logWarning(\n      `Failed to ${verbs.infinitive} event file via control plane store: ${filename}`,\n      String(err),\n    );\n    throw err;\n  }\n\n  return textResult(formatEventWriteResult(action, filename, payload));\n}\n\nfunction buildToolEventPayload(params: EventToolParams, context: EventToolContext): EventPayload {\n  if (!params.type) {\n    throw new Error(\"`type` is required for create and update actions\");\n  }\n  if (!params.text) {\n    throw new Error(\"`text` is required for create and update actions\");\n  }\n\n  const payload = buildEventPayload({\n    type: params.type,\n    platform: context.platform,\n    conversationId: context.conversationId,\n    conversationKind: context.conversationKind,\n    userId: context.userId,\n    text: params.text,\n    at: params.at,\n    schedule: params.schedule,\n    timezone: params.timezone,\n  });\n\n  if (payload.type === \"one-shot\" && new Date(payload.at).getTime() <= Date.now()) {\n    throw new Error(\n      `\\`at\\` must be in the future; got ${payload.at} (now=${new Date().toISOString()}). Check the timezone offset.`,\n    );\n  }\n\n  return payload;\n}\n\nfunction formatEventWriteResult(\n  action: \"create\" | \"update\",\n  filename: string,\n  payload: EventPayload,\n): string {\n  const scheduledVerb = action === \"update\" ? \"Updated\" : \"Scheduled\";\n  const immediateVerb = action === \"update\" ? \"Updated\" : \"Queued\";\n  const target = payload.platform\n    ? `${payload.platform}/${payload.conversationId}`\n    : payload.conversationId;\n  switch (payload.type) {\n    case \"periodic\":\n      return `${scheduledVerb} periodic event ${filename} for ${target} (${payload.schedule} ${payload.timezone}). ${formatUpcomingRuns(payload.schedule, payload.timezone)}`;\n    case \"one-shot\":\n      return `${scheduledVerb} one-shot event ${filename} for ${target} at ${payload.at}`;\n    case \"immediate\":\n      return `${immediateVerb} immediate event ${filename} for ${target}`;\n  }\n}\n\nfunction formatUpcomingRuns(schedule: string, timezone: string): string {\n  const format = new Intl.DateTimeFormat(\"en-CA\", {\n    timeZone: timezone,\n    weekday: \"short\",\n    year: \"numeric\",\n    month: \"2-digit\",\n    day: \"2-digit\",\n    hour: \"2-digit\",\n    minute: \"2-digit\",\n    hourCycle: \"h23\",\n  });\n  const runs = upcomingRuns(schedule, timezone, 3).map((run) => {\n    const part = (type: Intl.DateTimeFormatPartTypes) =>\n      format.formatToParts(run).find((p) => p.type === type)?.value;\n    return `${part(\"weekday\")} ${part(\"year\")}-${part(\"month\")}-${part(\"day\")} ${part(\"hour\")}:${part(\"minute\")}`;\n  });\n  return `Next runs: ${runs.join(\", \")} (${timezone})`;\n}\n\nfunction requireFilename(params: EventToolParams): string {\n  if (!params.filename) {\n    throw new Error(\"`filename` is required for read, update, and delete actions\");\n  }\n  return validateEventFilename(params.filename);\n}\n\nfunction sanitizeFileSegment(value: string): string {\n  const sanitized = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  return sanitized || \"event\";\n}\n"]}

package/dist/harness/tools/generate-image.d.ts

@@ -0,0 +1,20 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { Api, Model } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+export declare const GENERATE_IMAGE_TOOL = "generate_image";
+declare const schema: Type.TObject<{
+    label: Type.TString;
+    prompt: Type.TString;
+    size: Type.TOptional<Type.TString>;
+    quality: Type.TOptional<Type.TString>;
+}>;
+export declare function createGenerateImageTool(options: {
+    model: Model<Api>;
+    getApiKey: () => Promise<string | undefined>;
+    outputDir: string;
+}): {
+    tool: AgentTool<typeof schema>;
+    setUploadFunction: (fn: (hostPath: string, title?: string) => Promise<void>) => void;
+};
+export {};
+//# sourceMappingURL=generate-image.d.ts.map

package/dist/harness/tools/generate-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-image.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/generate-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAe,MAAM,SAAS,CAAC;AAO5C,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD,QAAA,MAAM,MAAM;;;;;EAOV,CAAC;AAgBH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG;IACF,IAAI,EAAE,SAAS,CAAC,OAAO,MAAM,CAAC,CAAC;IAC/B,iBAAiB,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;CACtF,CA6DA"}

package/dist/harness/tools/generate-image.js

@@ -0,0 +1,82 @@
+import { Type } from "typebox";
+import { Value } from "typebox/value";
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { LABEL_PARAMETER } from "./host-fn-tool.js";
+export const GENERATE_IMAGE_TOOL = "generate_image";
+const schema = Type.Object({
+    label: LABEL_PARAMETER,
+    prompt: Type.String({ description: "Description of the image to generate" }),
+    size: Type.Optional(Type.String({ description: "Requested image size, for example 1024x1024" })),
+    quality: Type.Optional(Type.String({ description: "Requested image quality, for example low, medium, or high" })),
+});
+const ImageResponseSchema = Type.Object({
+    data: Type.Optional(Type.Array(Type.Object({ b64_json: Type.Optional(Type.String()) }))),
+    error: Type.Optional(Type.Object({ message: Type.Optional(Type.String()) })),
+});
+function readImageResponse(text) {
+    try {
+        const parsed = JSON.parse(text);
+        return Value.Check(ImageResponseSchema, parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function createGenerateImageTool(options) {
+    let uploadFn = null;
+    return {
+        tool: {
+            name: GENERATE_IMAGE_TOOL,
+            label: "generate image",
+            description: "Generate an image with the configured model provider and attach it to the response.",
+            parameters: schema,
+            execute: async (_toolCallId, params, signal) => {
+                if (!uploadFn)
+                    throw new Error("Upload function not configured");
+                if (!options.model.baseUrl)
+                    throw new Error("Image generation requires a configured model baseUrl");
+                const apiKey = await options.getApiKey();
+                if (!apiKey)
+                    throw new Error(`No API key configured for ${options.model.provider}`);
+                const response = await fetch(`${options.model.baseUrl.replace(/\/$/, "")}/images/generations`, {
+                    method: "POST",
+                    signal,
+                    headers: {
+                        ...options.model.headers,
+                        Authorization: `Bearer ${apiKey}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({
+                        model: options.model.id,
+                        prompt: params.prompt,
+                        size: params.size || undefined,
+                        quality: params.quality || undefined,
+                        response_format: "b64_json",
+                    }),
+                });
+                const body = readImageResponse(await response.text());
+                if (!response.ok) {
+                    throw new Error(`Image generation with model "${options.model.id}" failed: ` +
+                        (body?.error?.message ?? `HTTP ${response.status}`));
+                }
+                const encoded = body?.data?.[0]?.b64_json;
+                if (!encoded)
+                    throw new Error("Image generation response contained no image");
+                const fileName = `generated-${randomUUID()}.png`;
+                const filePath = join(options.outputDir, fileName);
+                await writeFile(filePath, Buffer.from(encoded, "base64"));
+                await uploadFn(filePath, fileName);
+                return {
+                    content: [{ type: "text", text: `Generated and attached image: ${fileName}` }],
+                    details: { fileName },
+                };
+            },
+        },
+        setUploadFunction: (fn) => {
+            uploadFn = fn;
+        },
+    };
+}
+//# sourceMappingURL=generate-image.js.map

package/dist/harness/tools/generate-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-image.js","sourceRoot":"","sources":["../../../src/harness/tools/generate-image.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { Type, type Static } from \"typebox\";\nimport { Value } from \"typebox/value\";\nimport { writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\nimport { LABEL_PARAMETER } from \"./host-fn-tool.js\";\n\nexport const GENERATE_IMAGE_TOOL = \"generate_image\";\n\nconst schema = Type.Object({\n  label: LABEL_PARAMETER,\n  prompt: Type.String({ description: \"Description of the image to generate\" }),\n  size: Type.Optional(Type.String({ description: \"Requested image size, for example 1024x1024\" })),\n  quality: Type.Optional(\n    Type.String({ description: \"Requested image quality, for example low, medium, or high\" }),\n  ),\n});\n\nconst ImageResponseSchema = Type.Object({\n  data: Type.Optional(Type.Array(Type.Object({ b64_json: Type.Optional(Type.String()) }))),\n  error: Type.Optional(Type.Object({ message: Type.Optional(Type.String()) })),\n});\n\nfunction readImageResponse(text: string): Static<typeof ImageResponseSchema> | undefined {\n  try {\n    const parsed: unknown = JSON.parse(text);\n    return Value.Check(ImageResponseSchema, parsed) ? parsed : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function createGenerateImageTool(options: {\n  model: Model<Api>;\n  getApiKey: () => Promise<string | undefined>;\n  outputDir: string;\n}): {\n  tool: AgentTool<typeof schema>;\n  setUploadFunction: (fn: (hostPath: string, title?: string) => Promise<void>) => void;\n} {\n  let uploadFn: ((hostPath: string, title?: string) => Promise<void>) | null = null;\n\n  return {\n    tool: {\n      name: GENERATE_IMAGE_TOOL,\n      label: \"generate image\",\n      description:\n        \"Generate an image with the configured model provider and attach it to the response.\",\n      parameters: schema,\n      execute: async (_toolCallId, params, signal) => {\n        if (!uploadFn) throw new Error(\"Upload function not configured\");\n        if (!options.model.baseUrl)\n          throw new Error(\"Image generation requires a configured model baseUrl\");\n        const apiKey = await options.getApiKey();\n        if (!apiKey) throw new Error(`No API key configured for ${options.model.provider}`);\n\n        const response = await fetch(\n          `${options.model.baseUrl.replace(/\\/$/, \"\")}/images/generations`,\n          {\n            method: \"POST\",\n            signal,\n            headers: {\n              ...options.model.headers,\n              Authorization: `Bearer ${apiKey}`,\n              \"Content-Type\": \"application/json\",\n            },\n            body: JSON.stringify({\n              model: options.model.id,\n              prompt: params.prompt,\n              size: params.size || undefined,\n              quality: params.quality || undefined,\n              response_format: \"b64_json\",\n            }),\n          },\n        );\n        const body = readImageResponse(await response.text());\n        if (!response.ok) {\n          throw new Error(\n            `Image generation with model \"${options.model.id}\" failed: ` +\n              (body?.error?.message ?? `HTTP ${response.status}`),\n          );\n        }\n        const encoded = body?.data?.[0]?.b64_json;\n        if (!encoded) throw new Error(\"Image generation response contained no image\");\n\n        const fileName = `generated-${randomUUID()}.png`;\n        const filePath = join(options.outputDir, fileName);\n        await writeFile(filePath, Buffer.from(encoded, \"base64\"));\n        await uploadFn(filePath, fileName);\n\n        return {\n          content: [{ type: \"text\" as const, text: `Generated and attached image: ${fileName}` }],\n          details: { fileName },\n        };\n      },\n    },\n    setUploadFunction: (fn) => {\n      uploadFn = fn;\n    },\n  };\n}\n"]}

package/dist/harness/tools/history.d.ts

@@ -0,0 +1,20 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { Type, type Static } from "typebox";
+import type { Office } from "../../office/types.js";
+declare const historySchema: Type.TObject<{
+    label: Type.TString;
+    action: Type.TUnion<[Type.TLiteral<"sessions">, Type.TLiteral<"search">, Type.TLiteral<"read">, Type.TLiteral<"chat">]>;
+    query: Type.TOptional<Type.TString>;
+    session: Type.TOptional<Type.TString>;
+    limit: Type.TOptional<Type.TInteger>;
+    skip: Type.TOptional<Type.TInteger>;
+}>;
+type HistoryArgs = Omit<Static<typeof historySchema>, "label">;
+interface HistoryScope {
+    office: Office;
+    sessionKey: string;
+}
+export declare function runHistory(scope: HistoryScope, args: HistoryArgs): Promise<string>;
+export declare function createHistoryTool(scope: HistoryScope): AgentTool<typeof historySchema>;
+export {};
+//# sourceMappingURL=history.d.ts.map

package/dist/harness/tools/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE7E,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAepD,QAAA,MAAM,aAAa;;;;;;;EAiCjB,CAAC;AAEH,KAAK,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC;AAE/D,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAkRD,wBAAsB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAWxF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC,OAAO,aAAa,CAAC,CAetF"}