@ekairos/structure 1.21.53-beta.0

package/dist/dataset/steps.js

@@ -0,0 +1,166 @@
+import { resolveStoryRuntime } from "@ekairos/story/runtime";
+export async function structureGetOrCreateContextStep(params) {
+    "use step";
+    try {
+        const runtime = await resolveStoryRuntime(params.env);
+        const ctx = await runtime.store.getOrCreateContext({ key: params.contextKey });
+        return { ok: true, data: ctx };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: message };
+    }
+}
+export async function structureGetContextStep(params) {
+    "use step";
+    try {
+        const runtime = await resolveStoryRuntime(params.env);
+        const ctx = await runtime.store.getContext({ key: params.contextKey });
+        if (!ctx)
+            return { ok: false, error: "Context not found" };
+        return { ok: true, data: ctx };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: message };
+    }
+}
+export async function structureUpdateContextContentStep(params) {
+    "use step";
+    try {
+        const runtime = await resolveStoryRuntime(params.env);
+        const updated = await runtime.store.updateContextContent({ key: params.contextKey }, params.content);
+        return { ok: true, data: updated };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: message };
+    }
+}
+export async function structurePatchContextContentStep(params) {
+    "use step";
+    try {
+        const runtime = await resolveStoryRuntime(params.env);
+        const existing = await runtime.store.getOrCreateContext({ key: params.contextKey });
+        const existingContent = (existing?.content ?? {});
+        const existingStructure = (existingContent?.structure ?? {});
+        const patchStructure = (params.patch?.structure ?? {});
+        const next = {
+            ...existingContent,
+            ...params.patch,
+            structure: { ...existingStructure, ...patchStructure },
+        };
+        const updated = await runtime.store.updateContextContent({ key: params.contextKey }, next);
+        return { ok: true, data: updated };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: message };
+    }
+}
+export async function structureUploadRowsOutputJsonlStep(params) {
+    "use step";
+    try {
+        const runtime = await resolveStoryRuntime(params.env);
+        const db = runtime.db;
+        const storagePath = `/structure/${params.structureId}/output.jsonl`;
+        const fileBuffer = Buffer.from(params.contentBase64 ?? "", "base64");
+        const uploadResult = await db.storage.uploadFile(storagePath, fileBuffer, {
+            contentType: "application/x-ndjson",
+            contentDisposition: "output.jsonl",
+        });
+        const fileId = uploadResult?.data?.id;
+        if (!fileId)
+            return { ok: false, error: "Failed to upload file to storage" };
+        return { ok: true, data: { fileId, storagePath } };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: message };
+    }
+}
+export async function structureLinkRowsOutputFileToContextStep(params) {
+    "use step";
+    try {
+        const runtime = await resolveStoryRuntime(params.env);
+        const store = runtime.store;
+        const db = runtime.db;
+        const ctx = await store.getOrCreateContext({ key: params.contextKey });
+        const ctxId = ctx?.id;
+        if (!ctxId)
+            return { ok: false, error: "Context not found" };
+        await db.transact([db.tx.context_contexts[ctxId].link({ structure_output_file: params.fileId })]);
+        return { ok: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: message };
+    }
+}
+export async function structureUnlinkRowsOutputFileFromContextStep(params) {
+    "use step";
+    try {
+        const runtime = await resolveStoryRuntime(params.env);
+        const store = runtime.store;
+        const db = runtime.db;
+        const ctx = await store.getOrCreateContext({ key: params.contextKey });
+        const ctxId = ctx?.id;
+        if (!ctxId)
+            return { ok: false, error: "Context not found" };
+        await db.transact([db.tx.context_contexts[ctxId].unlink({ structure_output_file: params.fileId })]);
+        return { ok: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: message };
+    }
+}
+export async function structureGetContextWithRowsOutputFileStep(params) {
+    "use step";
+    try {
+        const runtime = await resolveStoryRuntime(params.env);
+        const db = runtime.db;
+        const query = (await db.query({
+            context_contexts: {
+                $: { where: { key: params.contextKey }, limit: 1 },
+                structure_output_file: {},
+            },
+        }));
+        const row = query.context_contexts?.[0];
+        if (!row)
+            return { ok: false, error: "Context not found" };
+        return { ok: true, data: row };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: message };
+    }
+}
+export async function structureReadRowsOutputJsonlStep(params) {
+    "use step";
+    try {
+        const contextKey = `structure:${params.structureId}`;
+        const runtime = await resolveStoryRuntime(params.env);
+        const db = runtime.db;
+        const query = (await db.query({
+            context_contexts: {
+                $: { where: { key: contextKey }, limit: 1 },
+                structure_output_file: {},
+            },
+        }));
+        const ctx = query.context_contexts?.[0];
+        if (!ctx)
+            return { ok: false, error: "Context not found" };
+        const linked = Array.isArray(ctx?.structure_output_file) ? ctx.structure_output_file[0] : ctx.structure_output_file;
+        const url = linked?.url;
+        if (!url)
+            return { ok: false, error: "Rows output file not found" };
+        const fileBuffer = await fetch(url).then((r) => r.arrayBuffer());
+        return { ok: true, data: { contentBase64: Buffer.from(fileBuffer).toString("base64") } };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: message };
+    }
+}
+//# sourceMappingURL=steps.js.map

package/dist/dataset/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/dataset/steps.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolveStoryRuntime, type StoryRuntime } from \"@ekairos/story/runtime\"\n\nexport type StructureContextContent = {\n  /**\n   * IMPORTANT:\n   * Story engine persists its own runtime state into `context.content`.\n   * To avoid clobbering, all structure metadata is namespaced under `structure`.\n   */\n  structure?: {\n    kind?: \"ekairos.structure\"\n    version?: number\n    structureId?: string\n    orgId?: string\n    createdAt?: number\n    updatedAt?: number\n    mode?: \"auto\" | \"schema\"\n    output?: \"rows\" | \"object\"\n    instructions?: string\n    sources?: any[]\n    outputSchema?: { title?: string; description?: string; schema: any }\n    state?: string\n    metrics?: { calculatedTotalRows?: number; actualGeneratedRowCount?: number }\n    outputs?: {\n      rows?: { format: \"jsonl\"; fileId: string; storagePath: string; rowCount?: number }\n      object?: { value: any }\n    }\n    error?: { message: string }\n  }\n}\n\nexport async function structureGetOrCreateContextStep(params: {\n  env: any\n  contextKey: string\n}): Promise<{ ok: true; data: any } | { ok: false; error: string }> {\n  \"use step\"\n  try {\n    const runtime: StoryRuntime = await resolveStoryRuntime(params.env)\n    const ctx = await runtime.store.getOrCreateContext({ key: params.contextKey })\n    return { ok: true, data: ctx }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    return { ok: false, error: message }\n  }\n}\n\nexport async function structureGetContextStep(params: {\n  env: any\n  contextKey: string\n}): Promise<{ ok: true; data: any } | { ok: false; error: string }> {\n  \"use step\"\n  try {\n    const runtime: StoryRuntime = await resolveStoryRuntime(params.env)\n    const ctx = await runtime.store.getContext({ key: params.contextKey })\n    if (!ctx) return { ok: false, error: \"Context not found\" }\n    return { ok: true, data: ctx }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    return { ok: false, error: message }\n  }\n}\n\nexport async function structureUpdateContextContentStep(params: {\n  env: any\n  contextKey: string\n  content: StructureContextContent\n}): Promise<{ ok: true; data: any } | { ok: false; error: string }> {\n  \"use step\"\n  try {\n    const runtime: StoryRuntime = await resolveStoryRuntime(params.env)\n    const updated = await runtime.store.updateContextContent({ key: params.contextKey }, params.content)\n    return { ok: true, data: updated }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    return { ok: false, error: message }\n  }\n}\n\nexport async function structurePatchContextContentStep(params: {\n  env: any\n  contextKey: string\n  patch: Partial<StructureContextContent>\n}): Promise<{ ok: true; data: any } | { ok: false; error: string }> {\n  \"use step\"\n  try {\n    const runtime: StoryRuntime = await resolveStoryRuntime(params.env)\n    const existing = await runtime.store.getOrCreateContext({ key: params.contextKey })\n    const existingContent = (existing?.content ?? {}) as Record<string, unknown>\n    const existingStructure = (existingContent?.structure ?? {}) as Record<string, unknown>\n    const patchStructure = ((params.patch as StructureContextContent)?.structure ?? {}) as Record<string, unknown>\n\n    const next = {\n      ...existingContent,\n      ...params.patch,\n      structure: { ...existingStructure, ...patchStructure },\n    }\n    const updated = await runtime.store.updateContextContent({ key: params.contextKey }, next as any)\n    return { ok: true, data: updated }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    return { ok: false, error: message }\n  }\n}\n\nexport async function structureUploadRowsOutputJsonlStep(params: {\n  env: any\n  structureId: string\n  contentBase64: string\n}): Promise<{ ok: true; data: { fileId: string; storagePath: string } } | { ok: false; error: string }> {\n  \"use step\"\n  try {\n    const runtime: StoryRuntime = await resolveStoryRuntime(params.env)\n    const db = runtime.db\n    const storagePath = `/structure/${params.structureId}/output.jsonl`\n    const fileBuffer = Buffer.from(params.contentBase64 ?? \"\", \"base64\")\n    const uploadResult = await db.storage.uploadFile(storagePath, fileBuffer, {\n      contentType: \"application/x-ndjson\",\n      contentDisposition: \"output.jsonl\",\n    })\n    const fileId = uploadResult?.data?.id\n    if (!fileId) return { ok: false, error: \"Failed to upload file to storage\" }\n    return { ok: true, data: { fileId, storagePath } }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    return { ok: false, error: message }\n  }\n}\n\nexport async function structureLinkRowsOutputFileToContextStep(params: {\n  env: any\n  contextKey: string\n  fileId: string\n}): Promise<{ ok: true } | { ok: false; error: string }> {\n  \"use step\"\n  try {\n    const runtime: StoryRuntime = await resolveStoryRuntime(params.env)\n    const store = runtime.store\n    const db = runtime.db\n    const ctx = await store.getOrCreateContext({ key: params.contextKey })\n    const ctxId = ctx?.id\n    if (!ctxId) return { ok: false, error: \"Context not found\" }\n\n    await db.transact([db.tx.context_contexts[ctxId].link({ structure_output_file: params.fileId })])\n    return { ok: true }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    return { ok: false, error: message }\n  }\n}\n\nexport async function structureUnlinkRowsOutputFileFromContextStep(params: {\n  env: any\n  contextKey: string\n  fileId: string\n}): Promise<{ ok: true } | { ok: false; error: string }> {\n  \"use step\"\n  try {\n    const runtime: StoryRuntime = await resolveStoryRuntime(params.env)\n    const store = runtime.store\n    const db = runtime.db\n    const ctx = await store.getOrCreateContext({ key: params.contextKey })\n    const ctxId = ctx?.id\n    if (!ctxId) return { ok: false, error: \"Context not found\" }\n\n    await db.transact([db.tx.context_contexts[ctxId].unlink({ structure_output_file: params.fileId })])\n    return { ok: true }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    return { ok: false, error: message }\n  }\n}\n\nexport async function structureGetContextWithRowsOutputFileStep(params: {\n  env: any\n  contextKey: string\n}): Promise<{ ok: true; data: any } | { ok: false; error: string }> {\n  \"use step\"\n  try {\n    const runtime: StoryRuntime = await resolveStoryRuntime(params.env)\n    const db = runtime.db\n    const query = (await db.query({\n      context_contexts: {\n        $: { where: { key: params.contextKey }, limit: 1 },\n        structure_output_file: {},\n      },\n    })) as any\n    const row = query.context_contexts?.[0]\n    if (!row) return { ok: false, error: \"Context not found\" }\n    return { ok: true, data: row }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    return { ok: false, error: message }\n  }\n}\n\nexport async function structureReadRowsOutputJsonlStep(params: {\n  env: any\n  structureId: string\n}): Promise<{ ok: true; data: { contentBase64: string } } | { ok: false; error: string }> {\n  \"use step\"\n  try {\n    const contextKey = `structure:${params.structureId}`\n    const runtime: StoryRuntime = await resolveStoryRuntime(params.env)\n    const db = runtime.db\n    const query = (await db.query({\n      context_contexts: {\n        $: { where: { key: contextKey }, limit: 1 },\n        structure_output_file: {},\n      },\n    })) as any\n    const ctx = query.context_contexts?.[0]\n    if (!ctx) return { ok: false, error: \"Context not found\" }\n    const linked = Array.isArray(ctx?.structure_output_file) ? ctx.structure_output_file[0] : ctx.structure_output_file\n    const url = linked?.url\n    if (!url) return { ok: false, error: \"Rows output file not found\" }\n\n    const fileBuffer = await fetch(url).then((r) => r.arrayBuffer())\n    return { ok: true, data: { contentBase64: Buffer.from(fileBuffer).toString(\"base64\") } }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    return { ok: false, error: message }\n  }\n}\n\n"]}

package/dist/datasetFiles.d.ts

@@ -0,0 +1,6 @@
+export declare const DATASET_OUTPUT_FILE_NAME = "output.jsonl";
+export declare const DATASET_OUTPUT_SCHEMA_FILE_NAME = "output_schema.json";
+export declare function getDatasetWorkstation(datasetId: string): string;
+export declare function getDatasetOutputPath(datasetId: string): string;
+export declare function getDatasetOutputSchemaPath(datasetId: string): string;
+//# sourceMappingURL=datasetFiles.d.ts.map

package/dist/datasetFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasetFiles.d.ts","sourceRoot":"","sources":["../src/datasetFiles.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,iBAAiB,CAAA;AACtD,eAAO,MAAM,+BAA+B,uBAAuB,CAAA;AAEnE,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpE"}

package/dist/datasetFiles.js

@@ -0,0 +1,12 @@
+export const DATASET_OUTPUT_FILE_NAME = "output.jsonl";
+export const DATASET_OUTPUT_SCHEMA_FILE_NAME = "output_schema.json";
+export function getDatasetWorkstation(datasetId) {
+    return `/vercel/sandbox/datasets/${datasetId}`;
+}
+export function getDatasetOutputPath(datasetId) {
+    return `${getDatasetWorkstation(datasetId)}/${DATASET_OUTPUT_FILE_NAME}`;
+}
+export function getDatasetOutputSchemaPath(datasetId) {
+    return `${getDatasetWorkstation(datasetId)}/${DATASET_OUTPUT_SCHEMA_FILE_NAME}`;
+}
+//# sourceMappingURL=datasetFiles.js.map

package/dist/datasetFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasetFiles.js","sourceRoot":"","sources":["../src/datasetFiles.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,cAAc,CAAA;AACtD,MAAM,CAAC,MAAM,+BAA+B,GAAG,oBAAoB,CAAA;AAEnE,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,4BAA4B,SAAS,EAAE,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,GAAG,qBAAqB,CAAC,SAAS,CAAC,IAAI,wBAAwB,EAAE,CAAA;AAC1E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,SAAiB;IAC1D,OAAO,GAAG,qBAAqB,CAAC,SAAS,CAAC,IAAI,+BAA+B,EAAE,CAAA;AACjF,CAAC","sourcesContent":["export const DATASET_OUTPUT_FILE_NAME = \"output.jsonl\"\nexport const DATASET_OUTPUT_SCHEMA_FILE_NAME = \"output_schema.json\"\n\nexport function getDatasetWorkstation(datasetId: string): string {\n  return `/vercel/sandbox/datasets/${datasetId}`\n}\n\nexport function getDatasetOutputPath(datasetId: string): string {\n  return `${getDatasetWorkstation(datasetId)}/${DATASET_OUTPUT_FILE_NAME}`\n}\n\nexport function getDatasetOutputSchemaPath(datasetId: string): string {\n  return `${getDatasetWorkstation(datasetId)}/${DATASET_OUTPUT_SCHEMA_FILE_NAME}`\n}\n\n"]}

package/dist/domain.d.ts

@@ -0,0 +1,2 @@
+export { structureDomain } from "./schema";
+//# sourceMappingURL=domain.d.ts.map

package/dist/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA"}

package/dist/domain.js

@@ -0,0 +1,2 @@
+export { structureDomain } from "./schema";
+//# sourceMappingURL=domain.js.map

package/dist/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA","sourcesContent":["export { structureDomain } from \"./schema\"\n\n"]}

package/dist/executeCommand.tool.d.ts

@@ -0,0 +1,35 @@
+interface ExecuteCommandToolParams {
+    datasetId: string;
+    sandboxId: string;
+    env?: any;
+}
+export declare function createExecuteCommandTool({ datasetId, sandboxId, env }: ExecuteCommandToolParams): import("ai").Tool<{
+    pythonCode: string;
+    scriptName: string;
+}, {
+    success: boolean;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    scriptPath: string;
+    error: string;
+    stdoutTruncated: boolean;
+    stderrTruncated: boolean;
+    stdoutOriginalLength: number;
+    stderrOriginalLength: number;
+    message?: undefined;
+} | {
+    success: boolean;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    scriptPath: string;
+    message: string;
+    stdoutTruncated: boolean;
+    stderrTruncated: boolean;
+    stdoutOriginalLength: number;
+    stderrOriginalLength: number;
+    error?: undefined;
+}>;
+export {};
+//# sourceMappingURL=executeCommand.tool.d.ts.map

package/dist/executeCommand.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeCommand.tool.d.ts","sourceRoot":"","sources":["../src/executeCommand.tool.ts"],"names":[],"mappings":"AAQA,UAAU,wBAAwB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,GAAG,CAAA;CACV;AAiBD,wBAAgB,wBAAwB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiG/F"}

package/dist/executeCommand.tool.js

@@ -0,0 +1,106 @@
+import { tool } from "ai";
+import { z } from "zod/v4";
+import { runDatasetSandboxCommandStep, writeDatasetSandboxTextFileStep } from "./sandbox/steps";
+import { getDatasetWorkstation } from "./datasetFiles";
+const MAX_STDOUT_CHARS = 20000;
+const MAX_STDERR_CHARS = 5000;
+function normalizeScriptName(scriptName) {
+    // Keep the AI-provided scriptName, but:
+    // - strip a trailing ".py" if it was included
+    // - avoid extra dots/spaces in filenames
+    const raw = String(scriptName ?? "").trim();
+    const noExt = raw.toLowerCase().endsWith(".py") ? raw.slice(0, -3) : raw;
+    const cleaned = noExt
+        .replace(/\\/g, "_")
+        .replace(/\//g, "_")
+        .replace(/\s+/g, "_")
+        .replace(/\./g, "_")
+        .replace(/[^a-zA-Z0-9_-]/g, "");
+    return cleaned.length > 0 ? cleaned : "script";
+}
+export function createExecuteCommandTool({ datasetId, sandboxId, env }) {
+    return tool({
+        description: "Execute Python scripts in the sandbox. Always saves script to a file before executing. The tool's output is EXACTLY the script's stdout and includes the script file path for traceability. CRITICAL: Print concise, human-readable summaries only; do NOT print raw large data. For big results, write artifacts to files in the workstation and print their file paths. Always include progress/result prints.",
+        inputSchema: z.object({
+            pythonCode: z
+                .string()
+                .describe("Python code to execute. Saved to a file before running. MANDATORY: Use print() to report progress and final results. Keep prints concise; avoid dumping rows/JSON."),
+            scriptName: z
+                .string()
+                .describe("Name for the script file in snake_case (e.g., 'inspect_file', 'parse_csv', 'generate_output'). The file will be saved as <scriptName>.py in the workstation."),
+        }),
+        execute: async ({ pythonCode, scriptName }) => {
+            console.log("[ekairos/structure] executeCommand.tool execute begin");
+            console.log("[ekairos/structure] executeCommand.tool execute datasetId", datasetId);
+            console.log("[ekairos/structure] executeCommand.tool execute scriptName", scriptName);
+            const workstation = getDatasetWorkstation(datasetId);
+            const scriptNameWithExt = `${normalizeScriptName(scriptName)}.py`;
+            const scriptFile = `${workstation}/${scriptNameWithExt}`;
+            console.log("[ekairos/structure] executeCommand.tool execute writingScript");
+            await writeDatasetSandboxTextFileStep({
+                env,
+                sandboxId,
+                path: scriptFile,
+                text: pythonCode,
+            });
+            console.log("[ekairos/structure] executeCommand.tool execute runningPython");
+            const result = await runDatasetSandboxCommandStep({
+                env,
+                sandboxId,
+                cmd: "python",
+                args: [scriptFile],
+            });
+            const stdout = result.stdout || "";
+            const stderr = result.stderr || "";
+            const exitCode = result.exitCode;
+            const isStdoutTruncated = stdout.length > MAX_STDOUT_CHARS;
+            const isStderrTruncated = stderr.length > MAX_STDERR_CHARS;
+            const stdoutCapped = isStdoutTruncated ? stdout.slice(0, MAX_STDOUT_CHARS) : stdout;
+            const stderrCapped = isStderrTruncated ? stderr.slice(0, MAX_STDERR_CHARS) : stderr;
+            if (exitCode !== 0) {
+                console.log("[ekairos/structure] executeCommand.tool execute failedExitCode");
+                return {
+                    success: false,
+                    exitCode,
+                    stdout: stdoutCapped,
+                    stderr: stderrCapped,
+                    scriptPath: scriptFile,
+                    error: "Command failed",
+                    stdoutTruncated: isStdoutTruncated,
+                    stderrTruncated: isStderrTruncated,
+                    stdoutOriginalLength: stdout.length,
+                    stderrOriginalLength: stderr.length,
+                };
+            }
+            if (stderr && (stderr.includes("Traceback") || stderr.toLowerCase().includes("error"))) {
+                console.log("[ekairos/structure] executeCommand.tool execute pythonErrorDetected");
+                return {
+                    success: false,
+                    exitCode,
+                    stdout: stdoutCapped,
+                    stderr: stderrCapped,
+                    scriptPath: scriptFile,
+                    error: "Python error detected",
+                    stdoutTruncated: isStdoutTruncated,
+                    stderrTruncated: isStderrTruncated,
+                    stdoutOriginalLength: stdout.length,
+                    stderrOriginalLength: stderr.length,
+                };
+            }
+            console.log("[ekairos/structure] executeCommand.tool execute ok");
+            return {
+                success: true,
+                exitCode,
+                stdout: stdoutCapped,
+                stderr: stderrCapped,
+                scriptPath: scriptFile,
+                message: "Command executed successfully",
+                stdoutTruncated: isStdoutTruncated,
+                stderrTruncated: isStderrTruncated,
+                stdoutOriginalLength: stdout.length,
+                stderrOriginalLength: stderr.length,
+            };
+        },
+    });
+}
+//# sourceMappingURL=executeCommand.tool.js.map

package/dist/executeCommand.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeCommand.tool.js","sourceRoot":"","sources":["../src/executeCommand.tool.ts"],"names":[],"mappings":"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","sourcesContent":["import { tool } from \"ai\"\nimport { z } from \"zod/v4\"\nimport { runDatasetSandboxCommandStep, writeDatasetSandboxTextFileStep } from \"./sandbox/steps\"\nimport { getDatasetWorkstation } from \"./datasetFiles\"\n\nconst MAX_STDOUT_CHARS = 20000\nconst MAX_STDERR_CHARS = 5000\n\ninterface ExecuteCommandToolParams {\n  datasetId: string\n  sandboxId: string\n  env?: any\n}\n\nfunction normalizeScriptName(scriptName: string): string {\n  // Keep the AI-provided scriptName, but:\n  // - strip a trailing \".py\" if it was included\n  // - avoid extra dots/spaces in filenames\n  const raw = String(scriptName ?? \"\").trim()\n  const noExt = raw.toLowerCase().endsWith(\".py\") ? raw.slice(0, -3) : raw\n  const cleaned = noExt\n    .replace(/\\\\/g, \"_\")\n    .replace(/\\//g, \"_\")\n    .replace(/\\s+/g, \"_\")\n    .replace(/\\./g, \"_\")\n    .replace(/[^a-zA-Z0-9_-]/g, \"\")\n  return cleaned.length > 0 ? cleaned : \"script\"\n}\n\nexport function createExecuteCommandTool({ datasetId, sandboxId, env }: ExecuteCommandToolParams) {\n  return tool({\n    description:\n      \"Execute Python scripts in the sandbox. Always saves script to a file before executing. The tool's output is EXACTLY the script's stdout and includes the script file path for traceability. CRITICAL: Print concise, human-readable summaries only; do NOT print raw large data. For big results, write artifacts to files in the workstation and print their file paths. Always include progress/result prints.\",\n    inputSchema: z.object({\n      pythonCode: z\n        .string()\n        .describe(\n          \"Python code to execute. Saved to a file before running. MANDATORY: Use print() to report progress and final results. Keep prints concise; avoid dumping rows/JSON.\",\n        ),\n      scriptName: z\n        .string()\n        .describe(\n          \"Name for the script file in snake_case (e.g., 'inspect_file', 'parse_csv', 'generate_output'). The file will be saved as <scriptName>.py in the workstation.\",\n        ),\n    }),\n    execute: async ({ pythonCode, scriptName }: { pythonCode: string; scriptName: string }) => {\n      console.log(\"[ekairos/structure] executeCommand.tool execute begin\")\n      console.log(\"[ekairos/structure] executeCommand.tool execute datasetId\", datasetId)\n      console.log(\"[ekairos/structure] executeCommand.tool execute scriptName\", scriptName)\n      const workstation = getDatasetWorkstation(datasetId)\n      const scriptNameWithExt = `${normalizeScriptName(scriptName)}.py`\n      const scriptFile = `${workstation}/${scriptNameWithExt}`\n\n      console.log(\"[ekairos/structure] executeCommand.tool execute writingScript\")\n      await writeDatasetSandboxTextFileStep({\n        env,\n        sandboxId,\n        path: scriptFile,\n        text: pythonCode,\n      })\n\n      console.log(\"[ekairos/structure] executeCommand.tool execute runningPython\")\n      const result = await runDatasetSandboxCommandStep({\n        env,\n        sandboxId,\n        cmd: \"python\",\n        args: [scriptFile],\n      })\n\n      const stdout = result.stdout || \"\"\n      const stderr = result.stderr || \"\"\n      const exitCode = result.exitCode\n\n      const isStdoutTruncated = stdout.length > MAX_STDOUT_CHARS\n      const isStderrTruncated = stderr.length > MAX_STDERR_CHARS\n\n      const stdoutCapped = isStdoutTruncated ? stdout.slice(0, MAX_STDOUT_CHARS) : stdout\n      const stderrCapped = isStderrTruncated ? stderr.slice(0, MAX_STDERR_CHARS) : stderr\n\n      if (exitCode !== 0) {\n        console.log(\"[ekairos/structure] executeCommand.tool execute failedExitCode\")\n        return {\n          success: false,\n          exitCode,\n          stdout: stdoutCapped,\n          stderr: stderrCapped,\n          scriptPath: scriptFile,\n          error: \"Command failed\",\n          stdoutTruncated: isStdoutTruncated,\n          stderrTruncated: isStderrTruncated,\n          stdoutOriginalLength: stdout.length,\n          stderrOriginalLength: stderr.length,\n        }\n      }\n\n      if (stderr && (stderr.includes(\"Traceback\") || stderr.toLowerCase().includes(\"error\"))) {\n        console.log(\"[ekairos/structure] executeCommand.tool execute pythonErrorDetected\")\n        return {\n          success: false,\n          exitCode,\n          stdout: stdoutCapped,\n          stderr: stderrCapped,\n          scriptPath: scriptFile,\n          error: \"Python error detected\",\n          stdoutTruncated: isStdoutTruncated,\n          stderrTruncated: isStderrTruncated,\n          stdoutOriginalLength: stdout.length,\n          stderrOriginalLength: stderr.length,\n        }\n      }\n\n      console.log(\"[ekairos/structure] executeCommand.tool execute ok\")\n      return {\n        success: true,\n        exitCode,\n        stdout: stdoutCapped,\n        stderr: stderrCapped,\n        scriptPath: scriptFile,\n        message: \"Command executed successfully\",\n        stdoutTruncated: isStdoutTruncated,\n        stderrTruncated: isStderrTruncated,\n        stdoutOriginalLength: stdout.length,\n        stderrOriginalLength: stderr.length,\n      }\n    },\n  })\n}\n\n"]}

package/dist/file/steps.d.ts

@@ -0,0 +1,8 @@
+export declare function readInstantFileStep(params: {
+    env: any;
+    fileId: string;
+}): Promise<{
+    contentBase64: string;
+    contentDisposition?: string;
+}>;
+//# sourceMappingURL=steps.d.ts.map

package/dist/file/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../src/file/steps.ts"],"names":[],"mappings":"AAGA,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,GAAG,EAAE,GAAG,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBlE"}

package/dist/file/steps.js

@@ -0,0 +1,20 @@
+import { resolveStoryRuntime } from "@ekairos/story/runtime";
+import { DatasetService } from "../service";
+export async function readInstantFileStep(params) {
+    "use step";
+    const runtime = (await resolveStoryRuntime(params.env));
+    const db = runtime.db;
+    const service = new DatasetService(db);
+    const file = await service.getFileById(params.fileId);
+    const fileRow = file?.$files?.[0];
+    const url = fileRow?.url;
+    if (!url) {
+        throw new Error("File not found or URL missing");
+    }
+    const fileBuffer = await fetch(url).then((response) => response.arrayBuffer());
+    return {
+        contentBase64: Buffer.from(fileBuffer).toString("base64"),
+        contentDisposition: fileRow["content-disposition"],
+    };
+}
+//# sourceMappingURL=steps.js.map

package/dist/file/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/file/steps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAGzC;IACC,UAAU,CAAA;IACV,MAAM,OAAO,GAAG,CAAC,MAAM,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAoB,CAAA;IAC1E,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,CAAA;IACrB,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACrD,MAAM,OAAO,GAAI,IAAuE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;IACrG,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,CAAA;IACxB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAClD,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;IAC9E,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACzD,kBAAkB,EAAG,OAAmC,CAAC,qBAAqB,CAAuB;KACtG,CAAA;AACH,CAAC","sourcesContent":["import { resolveStoryRuntime } from \"@ekairos/story/runtime\"\nimport { DatasetService } from \"../service\"\n\nexport async function readInstantFileStep(params: {\n  env: any\n  fileId: string\n}): Promise<{ contentBase64: string; contentDisposition?: string }> {\n  \"use step\"\n  const runtime = (await resolveStoryRuntime(params.env)) as { db: unknown }\n  const db = runtime.db\n  const service = new DatasetService(db)\n  const file = await service.getFileById(params.fileId)\n  const fileRow = (file as { $files?: Array<{ url?: string } & Record<string, unknown>> })?.$files?.[0]\n  const url = fileRow?.url\n  if (!url) {\n    throw new Error(\"File not found or URL missing\")\n  }\n  const fileBuffer = await fetch(url).then((response) => response.arrayBuffer())\n  return {\n    contentBase64: Buffer.from(fileBuffer).toString(\"base64\"),\n    contentDisposition: (fileRow as Record<string, unknown>)[\"content-disposition\"] as string | undefined,\n  }\n}\n\n"]}

package/dist/generateSchema.tool.d.ts

@@ -0,0 +1,22 @@
+interface GenerateSchemaToolParams {
+    datasetId: string;
+    sandboxId: string;
+    env?: any;
+}
+export declare function createGenerateSchemaTool({ datasetId, sandboxId, env }: GenerateSchemaToolParams): import("ai").Tool<{
+    schemaTitle: string;
+    schemaDescription: string;
+    schemaJson: string;
+}, {
+    success: boolean;
+    error: string;
+    message?: undefined;
+    schemaPath?: undefined;
+} | {
+    success: boolean;
+    message: string;
+    schemaPath: string;
+    error?: undefined;
+}>;
+export {};
+//# sourceMappingURL=generateSchema.tool.d.ts.map

package/dist/generateSchema.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateSchema.tool.d.ts","sourceRoot":"","sources":["../src/generateSchema.tool.ts"],"names":[],"mappings":"AAKA,UAAU,wBAAwB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,GAAG,CAAA;CACV;AAED,wBAAgB,wBAAwB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,wBAAwB;;;;;;;;;;;;;;GAwD/F"}

package/dist/generateSchema.tool.js

@@ -0,0 +1,61 @@
+import { tool } from "ai";
+import { z } from "zod/v4";
+import { writeDatasetSandboxTextFileStep } from "./sandbox/steps";
+import { getDatasetOutputSchemaPath } from "./datasetFiles";
+export function createGenerateSchemaTool({ datasetId, sandboxId, env }) {
+    return tool({
+        description: "Write the output JSON Schema to the sandbox so the story loop can lift it into context state. IMPORTANT: Field names must be lowerCamelCase. For rows output, schema should describe a single record. For object output, schema should describe the whole object.",
+        inputSchema: z.object({
+            schemaTitle: z.string().describe("Short schema title"),
+            schemaDescription: z.string().describe("Short schema description"),
+            schemaJson: z.string().describe("A JSON Schema string"),
+        }),
+        execute: async ({ schemaTitle, schemaDescription, schemaJson }) => {
+            console.log("[ekairos/structure] generateSchema.tool execute begin");
+            console.log("[ekairos/structure] generateSchema.tool execute datasetId", datasetId);
+            console.log("[ekairos/structure] generateSchema.tool execute sandboxId", sandboxId);
+            console.log("[ekairos/structure] generateSchema.tool execute schemaTitle", schemaTitle);
+            console.log("[ekairos/structure] generateSchema.tool execute schemaJsonLength", String(schemaJson ?? "").length);
+            const schemaData = {
+                title: schemaTitle,
+                description: schemaDescription,
+                schema: (() => {
+                    try {
+                        return JSON.parse(schemaJson);
+                    }
+                    catch (e) {
+                        const message = e instanceof Error ? e.message : String(e);
+                        console.log("[ekairos/structure] generateSchema.tool execute invalidSchemaJson");
+                        console.log("[ekairos/structure] generateSchema.tool execute invalidSchemaJsonMessage", message);
+                        console.log("[ekairos/structure] generateSchema.tool execute invalidSchemaJsonPreview", String(schemaJson ?? "").slice(0, 300));
+                        throw e;
+                    }
+                })(),
+            };
+            const schemaPath = getDatasetOutputSchemaPath(datasetId);
+            try {
+                console.log("[ekairos/structure] generateSchema.tool execute writingSchemaPath", schemaPath);
+                await writeDatasetSandboxTextFileStep({
+                    env,
+                    sandboxId,
+                    path: schemaPath,
+                    text: JSON.stringify(schemaData, null, 2),
+                });
+            }
+            catch (e) {
+                console.log("[ekairos/structure] generateSchema.tool execute failed");
+                const message = e instanceof Error ? e.message : String(e);
+                console.log("[ekairos/structure] generateSchema.tool execute failedMessage", message);
+                if (e instanceof Error && e.stack) {
+                    console.log("[ekairos/structure] generateSchema.tool execute failedStack", e.stack);
+                }
+                console.log("[ekairos/structure] generateSchema.tool execute failedSchemaPath", schemaPath);
+                console.log("[ekairos/structure] generateSchema.tool execute failedHasEnv", Boolean(env));
+                return { success: false, error: message };
+            }
+            console.log("[ekairos/structure] generateSchema.tool execute ok");
+            return { success: true, message: "Schema written", schemaPath };
+        },
+    });
+}
+//# sourceMappingURL=generateSchema.tool.js.map

package/dist/generateSchema.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateSchema.tool.js","sourceRoot":"","sources":["../src/generateSchema.tool.ts"],"names":[],"mappings":"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","sourcesContent":["import { tool } from \"ai\"\nimport { z } from \"zod/v4\"\nimport { writeDatasetSandboxTextFileStep } from \"./sandbox/steps\"\nimport { getDatasetOutputSchemaPath } from \"./datasetFiles\"\n\ninterface GenerateSchemaToolParams {\n  datasetId: string\n  sandboxId: string\n  env?: any\n}\n\nexport function createGenerateSchemaTool({ datasetId, sandboxId, env }: GenerateSchemaToolParams) {\n  return tool({\n    description:\n      \"Write the output JSON Schema to the sandbox so the story loop can lift it into context state. IMPORTANT: Field names must be lowerCamelCase. For rows output, schema should describe a single record. For object output, schema should describe the whole object.\",\n    inputSchema: z.object({\n      schemaTitle: z.string().describe(\"Short schema title\"),\n      schemaDescription: z.string().describe(\"Short schema description\"),\n      schemaJson: z.string().describe(\"A JSON Schema string\"),\n    }),\n    execute: async ({ schemaTitle, schemaDescription, schemaJson }: { schemaTitle: string; schemaDescription: string; schemaJson: string }) => {\n      console.log(\"[ekairos/structure] generateSchema.tool execute begin\")\n      console.log(\"[ekairos/structure] generateSchema.tool execute datasetId\", datasetId)\n      console.log(\"[ekairos/structure] generateSchema.tool execute sandboxId\", sandboxId)\n      console.log(\"[ekairos/structure] generateSchema.tool execute schemaTitle\", schemaTitle)\n      console.log(\"[ekairos/structure] generateSchema.tool execute schemaJsonLength\", String(schemaJson ?? \"\").length)\n      const schemaData = {\n        title: schemaTitle,\n        description: schemaDescription,\n        schema: (() => {\n          try {\n            return JSON.parse(schemaJson)\n          } catch (e) {\n            const message = e instanceof Error ? e.message : String(e)\n            console.log(\"[ekairos/structure] generateSchema.tool execute invalidSchemaJson\")\n            console.log(\"[ekairos/structure] generateSchema.tool execute invalidSchemaJsonMessage\", message)\n            console.log(\"[ekairos/structure] generateSchema.tool execute invalidSchemaJsonPreview\", String(schemaJson ?? \"\").slice(0, 300))\n            throw e\n          }\n        })(),\n      }\n\n      const schemaPath = getDatasetOutputSchemaPath(datasetId)\n      try {\n        console.log(\"[ekairos/structure] generateSchema.tool execute writingSchemaPath\", schemaPath)\n        await writeDatasetSandboxTextFileStep({\n          env,\n          sandboxId,\n          path: schemaPath,\n          text: JSON.stringify(schemaData, null, 2),\n        })\n      } catch (e) {\n        console.log(\"[ekairos/structure] generateSchema.tool execute failed\")\n        const message = e instanceof Error ? e.message : String(e)\n        console.log(\"[ekairos/structure] generateSchema.tool execute failedMessage\", message)\n        if (e instanceof Error && e.stack) {\n          console.log(\"[ekairos/structure] generateSchema.tool execute failedStack\", e.stack)\n        }\n        console.log(\"[ekairos/structure] generateSchema.tool execute failedSchemaPath\", schemaPath)\n        console.log(\"[ekairos/structure] generateSchema.tool execute failedHasEnv\", Boolean(env))\n        return { success: false, error: message }\n      }\n\n      console.log(\"[ekairos/structure] generateSchema.tool execute ok\")\n      return { success: true, message: \"Schema written\", schemaPath }\n    },\n  })\n}\n\n"]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./structure";
+export * from "./schema";
+export * from "./service";
+export * from "./datasetFiles";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./structure";
+export * from "./schema";
+export * from "./service";
+export * from "./datasetFiles";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA","sourcesContent":["export * from \"./structure\"\nexport * from \"./schema\"\nexport * from \"./service\"\nexport * from \"./datasetFiles\"\n\n"]}

package/dist/prompts.d.ts

@@ -0,0 +1,18 @@
+export type PreparedSource = {
+    kind: "file" | "dataset" | "text";
+    id: string;
+    path: string;
+    name?: string;
+    mimeType?: string;
+};
+export type StructurePromptContext = {
+    datasetId: string;
+    mode: "auto" | "schema";
+    output: "rows" | "object";
+    outputSchema?: any;
+    sources: PreparedSource[];
+    workstation: string;
+    outputPath: string;
+};
+export declare function buildStructurePrompt(ctx: StructurePromptContext): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAA;IACzB,YAAY,CAAC,EAAE,GAAG,CAAA;IAClB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,CA4DxE"}