@ekairos/structure 1.21.77-beta.0 → 1.21.78-beta.0

package/dist/clearDataset.tool.js

@@ -1,7 +1,7 @@
 import { tool } from "ai";
 import { z } from "zod/v4";
-import { runDatasetSandboxCommandStep } from "./sandbox/steps";
-import { getDatasetOutputPath } from "./datasetFiles";
+import { runDatasetSandboxCommandStep } from "./sandbox/steps.js";
+import { getDatasetOutputPath } from "./datasetFiles.js";
 export function createClearDatasetTool({ datasetId, sandboxId, env }) {
     return tool({
         description: "Clear output files and reset dataset status.",

package/dist/completeObject.tool.js

@@ -1,8 +1,8 @@
 import { tool } from "ai";
 import { z } from "zod/v4";
 import Ajv from "ajv";
-import { structureGetContextStep } from "./dataset/steps";
-import { readDatasetSandboxTextFileStep } from "./sandbox/steps";
+import { structureGetContextStep } from "./dataset/steps.js";
+import { readDatasetSandboxTextFileStep } from "./sandbox/steps.js";
 let ajvInstance = null;
 function getAjv() {
     if (!ajvInstance) {

package/dist/completeRows.tool.js

@@ -1,9 +1,9 @@
 import { tool } from "ai";
 import { z } from "zod/v4";
 import Ajv from "ajv";
-import { readDatasetSandboxFileStep, readDatasetSandboxTextFileStep, runDatasetSandboxCommandStep } from "./sandbox/steps";
-import { getDatasetOutputPath } from "./datasetFiles";
-import { structureGetContextStep, structureUploadRowsOutputJsonlStep } from "./dataset/steps";
+import { readDatasetSandboxFileStep, readDatasetSandboxTextFileStep, runDatasetSandboxCommandStep } from "./sandbox/steps.js";
+import { getDatasetOutputPath } from "./datasetFiles.js";
+import { structureGetContextStep, structureUploadRowsOutputJsonlStep } from "./dataset/steps.js";
 let ajvInstance = null;
 function getAjv() {
     if (!ajvInstance) {

package/dist/domain.d.ts

@@ -1 +1 @@
-export { structureDomain } from "./schema";
+export { structureDomain } from "./schema.js";

package/dist/domain.js

@@ -1 +1 @@
-export { structureDomain } from "./schema";
+export { structureDomain } from "./schema.js";

package/dist/executeCommand.tool.js

@@ -1,7 +1,7 @@
 import { tool } from "ai";
 import { z } from "zod/v4";
-import { runDatasetSandboxCommandStep, writeDatasetSandboxTextFileStep } from "./sandbox/steps";
-import { getDatasetWorkstation } from "./datasetFiles";
+import { runDatasetSandboxCommandStep, writeDatasetSandboxTextFileStep } from "./sandbox/steps.js";
+import { getDatasetWorkstation } from "./datasetFiles.js";
 const MAX_STDOUT_CHARS = 20000;
 const MAX_STDERR_CHARS = 5000;
 function normalizeScriptName(scriptName) {

package/dist/file/steps.js

@@ -3,7 +3,7 @@ export async function readInstantFileStep(params) {
     const { resolveStoryRuntime } = await import("@ekairos/story/runtime");
     const runtime = (await resolveStoryRuntime(params.env));
     const db = runtime.db;
-    const { DatasetService } = await import("../service");
+    const { DatasetService } = await import("../service.js");
     const service = new DatasetService(db);
     const file = await service.getFileById(params.fileId);
     const fileRow = file?.$files?.[0];

package/dist/generateSchema.tool.js

@@ -1,7 +1,7 @@
 import { tool } from "ai";
 import { z } from "zod/v4";
-import { writeDatasetSandboxTextFileStep } from "./sandbox/steps";
-import { getDatasetOutputSchemaPath } from "./datasetFiles";
+import { writeDatasetSandboxTextFileStep } from "./sandbox/steps.js";
+import { getDatasetOutputSchemaPath } from "./datasetFiles.js";
 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.",

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export * from "./structure";
-export * from "./schema";
-export * from "./service";
-export * from "./datasetFiles";
-export * from "./rowsOutputPaging";
+export * from "./structure.js";
+export * from "./schema.js";
+export * from "./service.js";
+export * from "./datasetFiles.js";
+export * from "./rowsOutputPaging.js";

package/dist/index.js

@@ -1,5 +1,5 @@
-export * from "./structure";
-export * from "./schema";
-export * from "./service";
-export * from "./datasetFiles";
-export * from "./rowsOutputPaging";
+export * from "./structure.js";
+export * from "./schema.js";
+export * from "./service.js";
+export * from "./datasetFiles.js";
+export * from "./rowsOutputPaging.js";

package/dist/rowsOutputPaging.js

@@ -1,6 +1,6 @@
-import { getDatasetOutputPath, getDatasetWorkstation } from "./datasetFiles";
-import { createDatasetSandboxStep, runDatasetSandboxCommandStep } from "./sandbox/steps";
-import { getStoryRuntime } from "./runtime";
+import { getDatasetOutputPath, getDatasetWorkstation } from "./datasetFiles.js";
+import { createDatasetSandboxStep, runDatasetSandboxCommandStep } from "./sandbox/steps.js";
+import { getStoryRuntime } from "./runtime.js";
 /**
  * Step 1/2:
  * Download the rows output.jsonl from Instant storage into a sandbox file.

package/dist/rowsOutputSplit.d.ts

@@ -1,4 +1,4 @@
-import type { StructureRowsOutputPagingCursor } from "./rowsOutputPaging";
+import type { StructureRowsOutputPagingCursor } from "./rowsOutputPaging.js";
 export type StructureSplitRowsOutputToDatasetResult = {
     datasetId?: string;
     rowsWritten: number;

package/dist/rowsOutputSplit.js

@@ -1,6 +1,6 @@
-import { getDatasetOutputPath, getDatasetWorkstation } from "./datasetFiles";
-import { readDatasetSandboxFileStep, runDatasetSandboxCommandStep } from "./sandbox/steps";
-import { getStoryRuntime } from "./runtime";
+import { getDatasetOutputPath, getDatasetWorkstation } from "./datasetFiles.js";
+import { readDatasetSandboxFileStep, runDatasetSandboxCommandStep } from "./sandbox/steps.js";
+import { getStoryRuntime } from "./runtime.js";
 /**
  * Step:
  * Split a sandbox-local `output.jsonl` into a child dataset (also `output.jsonl`) of up to `limit` ROW entries.

package/dist/sandbox/steps.js

@@ -1,4 +1,4 @@
-import { getDatasetWorkdirBase, getDaytonaVolumeMountPath, getDaytonaVolumeName } from "../datasetFiles";
+import { getDatasetWorkdirBase, getDaytonaVolumeMountPath, getDaytonaVolumeName } from "../datasetFiles.js";
 function parseOptionalNumber(value) {
     const parsed = Number(value);
     if (!Number.isFinite(parsed))

package/dist/steps/persistObjectFromStory.step.js

@@ -41,7 +41,7 @@ export async function persistObjectResultFromStoryStep(params) {
     const store = runtime.store;
     const contextKey = `structure:${params.datasetId}`;
     const events = await store.getEvents({ key: contextKey });
-    const { structurePatchContextContentStep, structureGetContextStep } = await import("../dataset/steps");
+    const { structurePatchContextContentStep, structureGetContextStep } = await import("../dataset/steps.js");
     const ctxResult = await structureGetContextStep({ env: params.env, contextKey });
     const existingContent = ctxResult.ok ? (ctxResult.data?.content ?? {}) : {};
     for (let i = events.length - 1; i >= 0; i--) {

package/dist/structure.d.ts

@@ -1,4 +1,4 @@
-import { type StructureRowsOutputPagingCursor } from "./rowsOutputPaging";
+import { type StructureRowsOutputPagingCursor } from "./rowsOutputPaging.js";
 import type { SandboxConfig } from "@ekairos/sandbox";
 export type StructureSource = {
     kind: "file";

package/dist/structure.js

@@ -1,19 +1,19 @@
 import { createStory, didToolExecute, USER_MESSAGE_TYPE, WEB_CHANNEL } from "@ekairos/story";
-import { getDatasetOutputPath, getDatasetOutputSchemaPath, getDatasetWorkstation, getDaytonaVolumeMountPath, getDaytonaVolumeName, } from "./datasetFiles";
-import { structureDownloadRowsOutputToSandboxStep, structureReadRowsOutputPageFromSandboxStep, } from "./rowsOutputPaging";
-import { structureSplitRowsOutputToDatasetStep } from "./rowsOutputSplit";
-import { createDatasetSandboxStep, readDatasetSandboxFileStep, readDatasetSandboxTextFileStep, runDatasetSandboxCommandStep, writeDatasetSandboxFilesStep, writeDatasetSandboxTextFileStep, } from "./sandbox/steps";
-import { readInstantFileStep } from "./file/steps";
-import { structureGetContextStep, structureGetContextWithRowsOutputFileStep, structureReadRowsOutputJsonlStep, } from "./dataset/steps";
+import { getDatasetOutputPath, getDatasetOutputSchemaPath, getDatasetWorkstation, getDaytonaVolumeMountPath, getDaytonaVolumeName, } from "./datasetFiles.js";
+import { structureDownloadRowsOutputToSandboxStep, structureReadRowsOutputPageFromSandboxStep, } from "./rowsOutputPaging.js";
+import { structureSplitRowsOutputToDatasetStep } from "./rowsOutputSplit.js";
+import { createDatasetSandboxStep, readDatasetSandboxFileStep, readDatasetSandboxTextFileStep, runDatasetSandboxCommandStep, writeDatasetSandboxFilesStep, writeDatasetSandboxTextFileStep, } from "./sandbox/steps.js";
+import { readInstantFileStep } from "./file/steps.js";
+import { structureGetContextStep, structureGetContextWithRowsOutputFileStep, structureReadRowsOutputJsonlStep, } from "./dataset/steps.js";
 import { getWorkflowMetadata } from "workflow";
-import { buildStructurePrompt } from "./prompts";
-import { createExecuteCommandTool } from "./executeCommand.tool";
-import { createGenerateSchemaTool } from "./generateSchema.tool";
-import { createClearDatasetTool } from "./clearDataset.tool";
-import { createCompleteRowsTool } from "./completeRows.tool";
-import { createCompleteObjectTool } from "./completeObject.tool";
-import { persistObjectResultFromStoryStep } from "./steps/persistObjectFromStory.step";
-import { structureCommitFromEventsStep } from "./steps/commitFromEvents.step";
+import { buildStructurePrompt } from "./prompts.js";
+import { createExecuteCommandTool } from "./executeCommand.tool.js";
+import { createGenerateSchemaTool } from "./generateSchema.tool.js";
+import { createClearDatasetTool } from "./clearDataset.tool.js";
+import { createCompleteRowsTool } from "./completeRows.tool.js";
+import { createCompleteObjectTool } from "./completeObject.tool.js";
+import { persistObjectResultFromStoryStep } from "./steps/persistObjectFromStory.step.js";
+import { structureCommitFromEventsStep } from "./steps/commitFromEvents.step.js";
 function createUuidV4() {
     // Pure JS uuidv4 (workflow-safe: avoids Node built-ins and @instantdb/admin)
     return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
@@ -23,6 +23,12 @@ function createUuidV4() {
     });
 }
 function assertRunningInsideWorkflow(params) {
+    const bypassRaw = String(process.env.STRUCTURE_ALLOW_NON_WORKFLOW ?? "")
+        .trim()
+        .toLowerCase();
+    if (bypassRaw === "1" || bypassRaw === "true" || bypassRaw === "yes") {
+        return { workflowRunId: `test-${Date.now()}` };
+    }
     try {
         const meta = getWorkflowMetadata();
         const runId = meta?.workflowRunId;
@@ -50,7 +56,7 @@ function guessTextFileExtension(mimeType, name) {
         return ".yaml";
     return ".txt";
 }
-function shouldSkipPipInstall() {
+function shouldSkipPipInstall(config) {
     const explicit = String(process.env.STRUCTURE_DAYTONA_SKIP_PIP_INSTALL ?? "").trim().toLowerCase();
     if (explicit === "1" || explicit === "true" || explicit === "yes")
         return true;
@@ -58,7 +64,16 @@ function shouldSkipPipInstall() {
     if (declarative === "1" || declarative === "true" || declarative === "yes")
         return true;
     const snapshot = String(process.env.STRUCTURE_DAYTONA_SNAPSHOT ?? "").trim();
-    return Boolean(snapshot);
+    if (snapshot)
+        return true;
+    const image = config?.daytona?.image;
+    if (typeof image === "string" && image.trim().toLowerCase().startsWith("declarative"))
+        return true;
+    if (image && typeof image === "object")
+        return true;
+    if (config?.daytona?.snapshot)
+        return true;
+    return false;
 }
 function getDefaultSandboxConfig(datasetId) {
     const volumeName = getDaytonaVolumeName();
@@ -78,6 +93,7 @@ function getDefaultSandboxConfig(datasetId) {
         purpose: "structure.dataset",
         params: { datasetId },
         daytona: {
+            image: "declarative",
             ephemeral: true,
             autoStopIntervalMin: 5,
             volumes,
@@ -95,6 +111,9 @@ function mergeSandboxConfig(base, override) {
         ...(base.daytona ?? {}),
         ...(override.daytona ?? {}),
     };
+    if (override.daytona?.snapshot && !override.daytona?.image) {
+        mergedDaytona.image = undefined;
+    }
     if (override.daytona && "volumes" in override.daytona) {
         mergedDaytona.volumes = override.daytona?.volumes;
     }
@@ -142,7 +161,7 @@ async function ensureSandboxPrepared(params) {
     const mkdirRes = await runDatasetSandboxCommandStep({ env, sandboxId, cmd: "mkdir", args: ["-p", workstation] });
     // Align with dataset sandbox behavior: install python deps up-front (once per dataset sandbox).
     // This avoids tool-level "install if used" heuristics and ensures scripts can import pandas.
-    if (!shouldSkipPipInstall()) {
+    if (!shouldSkipPipInstall(params.sandboxConfig)) {
         const pipInstall = await runDatasetSandboxCommandStep({
             env,
             sandboxId,
@@ -266,6 +285,7 @@ function createStructureStoryDefinition(config) {
             sandboxId,
             sources: config.sources,
             state: sandboxState,
+            sandboxConfig: resolvedSandboxConfig,
         });
         if (config.mode === "schema" && config.outputSchema) {
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekairos/structure",
-  "version": "1.21.77-beta.0",
+  "version": "1.21.78-beta.0",
   "description": "Ekairos Structure - Unified structured extraction (rows or object) from file/text/dataset inputs",
   "type": "module",
   "main": "dist/index.js",
@@ -36,7 +36,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ekairos/domain": "^1.21.77-beta.0",
+    "@ekairos/domain": "^1.21.78-beta.0",
     "@ekairos/sandbox": "^1.21.60-beta.0",
     "@instantdb/admin": "^0.22.13",
     "@instantdb/core": "^0.22.13",