struere 0.9.6 → 0.9.7

package/dist/bin/struere.js

@@ -19710,6 +19710,115 @@ async function getSyncState(organizationId, environment) {
   }
   return { error: `Unexpected response: ${JSON.stringify(result)}` };
 }
+async function compilePrompt(options) {
+  const credentials = loadCredentials();
+  const apiKey = getApiKey();
+  if (apiKey && !credentials?.token) {
+    const siteUrl = getSiteUrl();
+    try {
+      const response2 = await fetch(`${siteUrl}/v1/compile-prompt`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${apiKey}`
+        },
+        body: JSON.stringify({
+          slug: options.slug,
+          message: options.message,
+          channel: options.channel,
+          threadMetadata: options.threadMetadata
+        }),
+        signal: AbortSignal.timeout(30000)
+      });
+      const text2 = await response2.text();
+      let json2;
+      try {
+        json2 = JSON.parse(text2);
+      } catch {
+        return { error: text2 || `HTTP ${response2.status}` };
+      }
+      if (!response2.ok) {
+        return { error: json2.error || text2 };
+      }
+      return { result: json2 };
+    } catch (err) {
+      if (err instanceof DOMException && err.name === "TimeoutError") {
+        return { error: "Request timed out after 30s" };
+      }
+      return { error: `Network error: ${err instanceof Error ? err.message : String(err)}` };
+    }
+  }
+  if (credentials?.sessionId) {
+    await refreshToken();
+  }
+  const freshCredentials = loadCredentials();
+  const token = apiKey || freshCredentials?.token;
+  if (!token) {
+    return { error: "Not authenticated" };
+  }
+  const agentResponse = await fetch(`${CONVEX_URL}/api/query`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`
+    },
+    body: JSON.stringify({
+      path: "agents:getBySlug",
+      args: { slug: options.slug }
+    })
+  });
+  if (!agentResponse.ok) {
+    return { error: await agentResponse.text() };
+  }
+  const agentResult = await agentResponse.json();
+  if (agentResult.status === "error") {
+    return { error: agentResult.errorMessage || "Failed to look up agent" };
+  }
+  if (!agentResult.value) {
+    return { error: `Agent not found: ${options.slug}` };
+  }
+  const response = await fetch(`${CONVEX_URL}/api/action`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`
+    },
+    body: JSON.stringify({
+      path: "agents:compileSystemPrompt",
+      args: {
+        agentId: agentResult.value._id,
+        environment: options.environment,
+        sampleContext: {
+          message: options.message,
+          channel: options.channel,
+          threadMetadata: options.threadMetadata
+        }
+      }
+    }),
+    signal: AbortSignal.timeout(30000)
+  });
+  const text = await response.text();
+  let json;
+  try {
+    json = JSON.parse(text);
+  } catch {
+    return { error: text || `HTTP ${response.status}` };
+  }
+  if (!response.ok) {
+    const msg = json.errorData?.message || json.errorMessage || text;
+    return { error: msg };
+  }
+  if (json.status === "success" && json.value) {
+    return { result: json.value };
+  }
+  if (json.status === "success" && json.value === null) {
+    return { error: `Agent not found or no config for environment: ${options.environment}` };
+  }
+  if (json.status === "error") {
+    return { error: json.errorData?.message || json.errorMessage || "Unknown error from Convex" };
+  }
+  return { error: `Unexpected response: ${text}` };
+}
 async function getPullState(organizationId, environment = "development") {
   const credentials = loadCredentials();
   const apiKey = getApiKey();
@@ -19802,6 +19911,7 @@ async function browserLoginInternal(spinner) {
   const authPromise = new Promise((resolve, reject) => {
     const server = Bun.serve({
       port: AUTH_CALLBACK_PORT,
+      hostname: "127.0.0.1",
       async fetch(req) {
         const url = new URL(req.url);
         if (url.pathname === "/callback") {
@@ -20102,9 +20212,9 @@ logs/
 }
 function getEntityTypeTs(name, slug) {
   const displayName = name.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-  return `import { defineEntityType } from 'struere'
+  return `import { defineData } from 'struere'
 
-export default defineEntityType({
+export default defineData({
   name: "${displayName}",
   slug: "${slug}",
   schema: {
@@ -20520,11 +20630,11 @@ function validateObjectProperties(schema, path) {
   }
 }
 
-function defineEntityType(config) {
-  if (!config.name) throw new Error('Entity type name is required')
-  if (!config.slug) throw new Error('Entity type slug is required')
-  if (!config.schema) throw new Error('Entity type schema is required')
-  if (config.schema.type !== 'object') throw new Error('Entity type schema must be an object type')
+function defineData(config) {
+  if (!config.name) throw new Error('Data type name is required')
+  if (!config.slug) throw new Error('Data type slug is required')
+  if (!config.schema) throw new Error('Data type schema is required')
+  if (config.schema.type !== 'object') throw new Error('Data type schema must be an object type')
   if (config.schema.properties) {
     for (const [key, value] of Object.entries(config.schema.properties)) {
       validateObjectProperties(value, key)
@@ -20599,7 +20709,7 @@ function defineConfig(config) {
   }
 }
 
-export { defineAgent, defineRole, defineEntityType, defineTrigger, defineTools, defineConfig }
+export { defineAgent, defineRole, defineData, defineTrigger, defineTools, defineConfig }
 `;
 function registerStruerePlugin() {
   if (registered)
@@ -20776,7 +20886,7 @@ var TYPE_DECLARATIONS = `declare module 'struere' {
 
   export function defineAgent(config: AgentConfig): AgentConfig
   export function defineRole(config: RoleConfig): RoleConfig
-  export function defineEntityType(config: EntityTypeConfig): EntityTypeConfig
+  export function defineData(config: EntityTypeConfig): EntityTypeConfig
   export function defineTrigger(config: TriggerConfig): TriggerConfig
   export function defineTools(tools: ToolDefinition[]): ToolReference[]
   export function defineConfig(config?: Partial<FrameworkConfig>): FrameworkConfig
@@ -20950,7 +21060,7 @@ function buildProjectContext(orgName, resources) {
   }
   if (resources.entityTypes.length > 0) {
     lines.push("");
-    lines.push(`### Entity Types (${resources.entityTypes.length})`);
+    lines.push(`### Data Types (${resources.entityTypes.length})`);
     for (const et of resources.entityTypes) {
       const fields = et.schema?.properties ? Object.keys(et.schema.properties).join(", ") : "";
       const fieldStr = fields ? ` \u2014 fields: ${fields}` : "";
@@ -20986,7 +21096,7 @@ function buildDocument(projectContext) {
   const lines = [];
   lines.push(`# Struere Workspace`);
   lines.push("");
-  lines.push(`> This is a Struere workspace project. You define agents, entity types, roles, triggers, and custom tools here. The CLI syncs them to the Convex backend.`);
+  lines.push(`> This is a Struere workspace project. You define agents, data types, roles, triggers, and custom tools here. The CLI syncs them to the Convex backend.`);
   lines.push("");
   lines.push(`## Agent Usage`);
   lines.push("");
@@ -21006,7 +21116,7 @@ function buildDocument(projectContext) {
   lines.push("");
   lines.push("**JSON output**: Most commands support `--json` for structured output:");
   lines.push("```bash");
-  lines.push("struere entities list <type> --json");
+  lines.push("struere data list <type> --json");
   lines.push("struere status --json");
   lines.push("struere deploy --json --force");
   lines.push("```");
@@ -21023,7 +21133,7 @@ function buildDocument(projectContext) {
   lines.push("");
   lines.push("```");
   lines.push("agents/              # Agent definitions (one file per agent)");
-  lines.push("entity-types/        # Entity type schemas (like DB tables)");
+  lines.push("entity-types/        # Data type schemas (like DB tables)");
   lines.push("roles/               # RBAC roles with policies, scope rules, field masks");
   lines.push("triggers/            # Automation rules (react to entity changes)");
   lines.push("tools/index.ts       # Custom tools shared by all agents");
@@ -21039,16 +21149,16 @@ function buildDocument(projectContext) {
   lines.push("| `struere sync` | One-shot sync to Convex and exit (agent-friendly) |");
   lines.push("| `struere dev` | Watch files and sync to Convex on save |");
   lines.push("| `struere deploy` | Push development config to production |");
-  lines.push("| `struere add agent\\|entity-type\\|role\\|trigger\\|eval\\|fixture <name>` | Scaffold a new resource |");
+  lines.push("| `struere add agent\\|data-type\\|role\\|trigger\\|eval\\|fixture <name>` | Scaffold a new resource |");
   lines.push("| `struere status` | Compare local vs remote state |");
   lines.push("| `struere pull` | Download remote resources to local files |");
-  lines.push("| `struere entities types` | List entity types in an environment |");
-  lines.push("| `struere entities list <type>` | List entities (supports `--status`, `--limit`, `--json`) |");
-  lines.push("| `struere entities get <id>` | Get entity details |");
-  lines.push("| `struere entities create <type>` | Create entity (interactive or `--data <json>`) |");
-  lines.push("| `struere entities update <id>` | Update entity (`--data <json>`, `--status`) |");
-  lines.push("| `struere entities delete <id>` | Delete entity (with confirmation) |");
-  lines.push("| `struere entities search <type> <query>` | Search entities by text |");
+  lines.push("| `struere data types` | List data types in an environment |");
+  lines.push("| `struere data list <type>` | List records (supports `--status`, `--limit`, `--json`) |");
+  lines.push("| `struere data get <id>` | Get record details |");
+  lines.push("| `struere data create <type>` | Create record (interactive or `--data <json>`) |");
+  lines.push("| `struere data update <id>` | Update record (`--data <json>`, `--status`) |");
+  lines.push("| `struere data delete <id>` | Delete record (with confirmation) |");
+  lines.push("| `struere data search <type> <query>` | Search records by text |");
   lines.push("| `struere eval run <suite>` | Run an eval suite and write Markdown results |");
   lines.push("| `struere eval run <suite> --case <name>` | Run specific case(s) by name |");
   lines.push("| `struere eval run <suite> --tag <tag>` | Run cases matching a tag |");
@@ -21060,7 +21170,7 @@ function buildDocument(projectContext) {
   lines.push("");
   lines.push(`## Key Patterns`);
   lines.push("");
-  lines.push("- **Imports**: `import { defineAgent, defineEntityType, defineRole, defineTrigger, defineTools } from 'struere'`");
+  lines.push("- **Imports**: `import { defineAgent, defineData, defineRole, defineTrigger, defineTools } from 'struere'`");
   lines.push("- **Default model**: `grok-4-1-fast` (provider: `xai`). Also supports `anthropic`, `openai` and `google`");
   lines.push("- **Scope rule values**: `actor.userId`, `actor.entityId`, `actor.organizationId`, `actor.relatedIds:TYPE`, `literal:VALUE`");
   lines.push("- **Policy actions**: `create`, `read`, `update`, `delete`, `list` (deny overrides allow)");
@@ -21157,7 +21267,7 @@ function buildDocument(projectContext) {
   lines.push("### SDK");
   lines.push(`- [SDK Overview](${DOCS_BASE}/sdk/overview.md)`);
   lines.push(`- [defineAgent](${DOCS_BASE}/sdk/define-agent.md)`);
-  lines.push(`- [defineEntityType](${DOCS_BASE}/sdk/define-entity-type.md)`);
+  lines.push(`- [defineData](${DOCS_BASE}/sdk/define-data.md)`);
   lines.push(`- [defineRole](${DOCS_BASE}/sdk/define-role.md)`);
   lines.push(`- [defineTrigger](${DOCS_BASE}/sdk/define-trigger.md)`);
   lines.push(`- [defineTools](${DOCS_BASE}/sdk/define-tools.md)`);
@@ -21168,7 +21278,7 @@ function buildDocument(projectContext) {
   lines.push(`- [System Prompt Templates](${DOCS_BASE}/tools/system-prompt-templates.md)`);
   lines.push("");
   lines.push("### Platform");
-  lines.push(`- [Entities](${DOCS_BASE}/platform/entities.md)`);
+  lines.push(`- [Data](${DOCS_BASE}/platform/data.md)`);
   lines.push(`- [Permissions](${DOCS_BASE}/platform/permissions.md)`);
   lines.push(`- [Agents](${DOCS_BASE}/platform/agents.md)`);
   lines.push(`- [Events](${DOCS_BASE}/platform/events.md)`);
@@ -21505,7 +21615,7 @@ var initCommand = new Command("init").description("Initialize a new Struere orga
   console.log();
   console.log(source_default.gray("Project structure:"));
   console.log(source_default.gray("  agents/       "), source_default.cyan("Agent definitions"));
-  console.log(source_default.gray("  entity-types/ "), source_default.cyan("Entity type schemas"));
+  console.log(source_default.gray("  entity-types/ "), source_default.cyan("Data type schemas"));
   console.log(source_default.gray("  roles/        "), source_default.cyan("Role + permission definitions"));
   console.log(source_default.gray("  tools/        "), source_default.cyan("Shared custom tools"));
   console.log();
@@ -21563,7 +21673,9 @@ var BUILTIN_TOOLS = [
   "airtable.createRecords",
   "airtable.updateRecords",
   "airtable.deleteRecords",
-  "email.send"
+  "email.send",
+  "payment.create",
+  "payment.getStatus"
 ];
 function extractSyncPayload(resources) {
   const customToolsMap = new Map;
@@ -21618,7 +21730,9 @@ function extractSyncPayload(resources) {
         userMessage: t.user,
         assertions: t.assertions
       })),
-      finalAssertions: c.finalAssertions
+      finalAssertions: c.finalAssertions,
+      channel: c.channel,
+      contextParams: c.contextParams
     }))
   })) : undefined;
   const triggers = resources.triggers.length > 0 ? resources.triggers.map((t) => ({
@@ -21734,7 +21848,9 @@ function getBuiltinToolDescription(name) {
     "airtable.createRecords": "Create up to 10 records in an Airtable table",
     "airtable.updateRecords": "Update up to 10 records in an Airtable table",
     "airtable.deleteRecords": "Delete up to 10 records from an Airtable table",
-    "email.send": "Send an email via Resend"
+    "email.send": "Send an email via Resend",
+    "payment.create": "Create a payment link via Flow.cl and return the URL",
+    "payment.getStatus": "Check the current status of a payment"
   };
   return descriptions[name] || name;
 }
@@ -22042,6 +22158,24 @@ function getBuiltinToolParameters(name) {
         replyTo: { type: "string", description: "Reply-to email address" }
       },
       required: ["to", "subject"]
+    },
+    "payment.create": {
+      type: "object",
+      properties: {
+        amount: { type: "number", description: "Payment amount in the smallest currency unit" },
+        description: { type: "string", description: "Description of the payment" },
+        currency: { type: "string", description: "Currency code (defaults to CLP)" },
+        customerEmail: { type: "string", description: "Customer email address" },
+        entityId: { type: "string", description: "Optional entity ID to link the payment to" }
+      },
+      required: ["amount", "description"]
+    },
+    "payment.getStatus": {
+      type: "object",
+      properties: {
+        entityId: { type: "string", description: "Payment entity ID to check status for" }
+      },
+      required: ["entityId"]
     }
   };
   return schemas[name] || { type: "object", properties: {} };
@@ -22118,7 +22252,7 @@ async function checkForDeletions(resources, organizationId, environment) {
     deletions.push({ type: "Agents", remote: remoteState.agents.length, local: payload.agents.length, deleted: deletedAgents });
   const deletedEntityTypes = remoteState.entityTypes.filter((et) => !localSlugs.entityTypes.has(et.slug)).map((et) => et.name);
   if (deletedEntityTypes.length > 0)
-    deletions.push({ type: "Entity types", remote: remoteState.entityTypes.length, local: payload.entityTypes.length, deleted: deletedEntityTypes });
+    deletions.push({ type: "Data types", remote: remoteState.entityTypes.length, local: payload.entityTypes.length, deleted: deletedEntityTypes });
   const deletedRoles = remoteState.roles.filter((r) => !localSlugs.roles.has(r.name)).map((r) => r.name);
   if (deletedRoles.length > 0)
     deletions.push({ type: "Roles", remote: remoteState.roles.length, local: payload.roles.length, deleted: deletedRoles });
@@ -22223,7 +22357,7 @@ var syncCommand = new Command("sync").description("Sync resources to Convex and
       process.exit(1);
     }
     if (!jsonMode && !options.dryRun)
-      output.succeed(`Loaded ${resources.agents.length} agents, ${resources.entityTypes.length} entity types, ${resources.roles.length} roles`);
+      output.succeed(`Loaded ${resources.agents.length} agents, ${resources.entityTypes.length} data types, ${resources.roles.length} roles`);
   } catch (error) {
     if (jsonMode) {
       console.log(JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }));
@@ -22255,7 +22389,7 @@ var syncCommand = new Command("sync").description("Sync resources to Convex and
       console.log(source_default.bold("Dry run \u2014 nothing will be synced"));
       console.log();
       console.log(source_default.gray("  Agents:"), payload.agents.map((a) => a.slug).join(", ") || "none");
-      console.log(source_default.gray("  Entity types:"), payload.entityTypes.map((et) => et.slug).join(", ") || "none");
+      console.log(source_default.gray("  Data types:"), payload.entityTypes.map((et) => et.slug).join(", ") || "none");
       console.log(source_default.gray("  Roles:"), payload.roles.map((r) => r.name).join(", ") || "none");
       console.log(source_default.gray("  Triggers:"), (payload.triggers || []).map((t) => t.slug).join(", ") || "none");
       if (deletions.length > 0) {
@@ -22421,7 +22555,7 @@ var devCommand = new Command("dev").description("Watch files and sync to develop
   spinner.start("Loading resources");
   try {
     loadedResources = await loadAllResources(cwd);
-    spinner.succeed(`Loaded ${loadedResources.agents.length} agents, ${loadedResources.entityTypes.length} entity types, ${loadedResources.roles.length} roles, ${loadedResources.customTools.length} custom tools, ${loadedResources.evalSuites.length} eval suites, ${loadedResources.triggers.length} triggers, ${loadedResources.fixtures.length} fixtures`);
+    spinner.succeed(`Loaded ${loadedResources.agents.length} agents, ${loadedResources.entityTypes.length} data types, ${loadedResources.roles.length} roles, ${loadedResources.customTools.length} custom tools, ${loadedResources.evalSuites.length} eval suites, ${loadedResources.triggers.length} triggers, ${loadedResources.fixtures.length} fixtures`);
     for (const err of loadedResources.errors) {
       console.log(source_default.red("  \u2716"), err);
     }
@@ -22634,7 +22768,7 @@ var deployCommand = new Command("deploy").description("Deploy all resources to p
   try {
     resources = await loadAllResources(cwd);
     if (!jsonMode)
-      spinner.succeed(`Loaded ${resources.agents.length} agents, ${resources.entityTypes.length} entity types, ${resources.roles.length} roles, ${resources.customTools.length} custom tools, ${resources.evalSuites.length} eval suites`);
+      spinner.succeed(`Loaded ${resources.agents.length} agents, ${resources.entityTypes.length} data types, ${resources.roles.length} roles, ${resources.customTools.length} custom tools, ${resources.evalSuites.length} eval suites`);
     for (const err of resources.errors) {
       if (!jsonMode)
         console.log(source_default.red("  \u2716"), err);
@@ -22698,7 +22832,7 @@ var deployCommand = new Command("deploy").description("Deploy all resources to p
       console.log(source_default.gray("  -"), `${source_default.cyan(agent.name)} (${agent.slug}) v${agent.version}`);
     }
     console.log();
-    console.log("Entity types:");
+    console.log("Data types:");
     for (const et of resources.entityTypes) {
       console.log(source_default.gray("  -"), source_default.cyan(et.name), `(${et.slug})`);
     }
@@ -22976,7 +23110,7 @@ var whoamiCommand = new Command("whoami").description("Show current logged in us
 });
 
 // src/cli/commands/add.ts
-var addCommand = new Command("add").description("Scaffold a new resource").argument("<type>", "Resource type: agent, entity-type, role, eval, trigger, or fixture").argument("<name>", "Resource name").action(async (type, name) => {
+var addCommand = new Command("add").description("Scaffold a new resource").argument("<type>", "Resource type: agent, data-type, role, eval, trigger, or fixture").argument("<name>", "Resource name").action(async (type, name) => {
   const cwd = process.cwd();
   console.log();
   if (!hasProject(cwd)) {
@@ -23003,17 +23137,19 @@ var addCommand = new Command("add").description("Scaffold a new resource").argum
         console.log(source_default.yellow("Agent already exists:"), `agents/${slug}.ts`);
       }
       break;
+    case "data-type":
+    case "datatype":
     case "entity-type":
     case "entitytype":
     case "type":
       result = scaffoldEntityType(cwd, displayName, slug);
       if (result.createdFiles.length > 0) {
-        console.log(source_default.green("\u2713"), `Created entity type "${displayName}"`);
+        console.log(source_default.green("\u2713"), `Created data type "${displayName}"`);
         for (const file of result.createdFiles) {
           console.log(source_default.gray("  \u2192"), file);
         }
       } else {
-        console.log(source_default.yellow("Entity type already exists:"), `entity-types/${slug}.ts`);
+        console.log(source_default.yellow("Data type already exists:"), `entity-types/${slug}.ts`);
       }
       break;
     case "role":
@@ -23070,10 +23206,10 @@ var addCommand = new Command("add").description("Scaffold a new resource").argum
       console.log();
       console.log("Available types:");
       console.log(source_default.gray("  -"), source_default.cyan("agent"), "- Create an AI agent");
-      console.log(source_default.gray("  -"), source_default.cyan("entity-type"), "- Create an entity type schema");
+      console.log(source_default.gray("  -"), source_default.cyan("data-type"), "- Create a data type schema");
       console.log(source_default.gray("  -"), source_default.cyan("role"), "- Create a role with permissions");
       console.log(source_default.gray("  -"), source_default.cyan("eval"), "- Create an eval suite (YAML)");
-      console.log(source_default.gray("  -"), source_default.cyan("trigger"), "- Create an entity trigger");
+      console.log(source_default.gray("  -"), source_default.cyan("trigger"), "- Create a data trigger");
       console.log(source_default.gray("  -"), source_default.cyan("fixture"), "- Create a test data fixture (YAML)");
       console.log();
       process.exit(1);
@@ -23153,7 +23289,7 @@ var statusCommand = new Command("status").description("Compare local vs remote s
   try {
     localResources = await loadAllResources(cwd);
     if (!jsonMode) {
-      spinner.succeed(`Loaded ${localResources.agents.length} agents, ${localResources.entityTypes.length} entity types, ${localResources.roles.length} roles, ${localResources.customTools.length} custom tools, ${localResources.evalSuites.length} eval suites`);
+      spinner.succeed(`Loaded ${localResources.agents.length} agents, ${localResources.entityTypes.length} data types, ${localResources.roles.length} roles, ${localResources.customTools.length} custom tools, ${localResources.evalSuites.length} eval suites`);
       for (const err of localResources.errors) {
         console.log(source_default.red("  \u2716"), err);
       }
@@ -23241,10 +23377,10 @@ var statusCommand = new Command("status").description("Compare local vs remote s
     }
   }
   console.log();
-  console.log(source_default.bold("Entity Types"));
+  console.log(source_default.bold("Data Types"));
   console.log(source_default.gray("\u2500".repeat(60)));
   if (localResources.entityTypes.length === 0 && devState.entityTypes.length === 0) {
-    console.log(source_default.gray("  No entity types"));
+    console.log(source_default.gray("  No data types"));
   } else {
     for (const et of localResources.entityTypes) {
       const remote = devState.entityTypes.find((r) => r.slug === et.slug);
@@ -23390,9 +23526,9 @@ function generateEntityTypeFile(entityType) {
   if (entityType.displayConfig) {
     parts.push(`  displayConfig: ${stringifyValue(entityType.displayConfig, 2)}`);
   }
-  return `import { defineEntityType } from 'struere'
+  return `import { defineData } from 'struere'
 
-export default defineEntityType({
+export default defineData({
 ${parts.join(`,
 `)},
 })
@@ -24001,20 +24137,20 @@ function flattenEntityForTable(entity) {
     status: entity.status
   };
 }
-var entitiesCommand = new Command("entities").description("Manage entity data");
-entitiesCommand.command("types").description("List available entity types").option("--env <environment>", "Environment (development|production)", "development").option("--json", "Output raw JSON").action(async (opts) => {
+var entitiesCommand = new Command("data").description("Manage data records");
+entitiesCommand.command("types").description("List available data types").option("--env <environment>", "Environment (development|production)", "development").option("--json", "Output raw JSON").action(async (opts) => {
   await ensureAuth();
   const spinner = ora();
   const env2 = opts.env;
   const orgId = getOrgId();
-  spinner.start("Fetching entity types");
+  spinner.start("Fetching data types");
   const { data, error } = await queryEntityTypes(env2, orgId);
   if (error || !data) {
-    spinner.fail("Failed to fetch entity types");
+    spinner.fail("Failed to fetch data types");
     console.log(source_default.red("Error:"), error);
     process.exit(1);
   }
-  spinner.succeed("Entity types loaded");
+  spinner.succeed("Data types loaded");
   const types = data;
   if (opts.json) {
     console.log(JSON.stringify(types, null, 2));
@@ -24037,12 +24173,12 @@ entitiesCommand.command("types").description("List available entity types").opti
   }));
   console.log();
 });
-entitiesCommand.command("list <type>").description("List entities of a type").option("--env <environment>", "Environment (development|production)", "development").option("--status <status>", "Filter by status").option("--limit <n>", "Maximum results", "50").option("--json", "Output raw JSON").action(async (type, opts) => {
+entitiesCommand.command("list <type>").description("List records of a type").option("--env <environment>", "Environment (development|production)", "development").option("--status <status>", "Filter by status").option("--limit <n>", "Maximum results", "50").option("--json", "Output raw JSON").action(async (type, opts) => {
   await ensureAuth();
   const spinner = ora();
   const env2 = opts.env;
   const orgId = getOrgId();
-  spinner.start(`Fetching ${type} entities`);
+  spinner.start(`Fetching ${type} records`);
   const [entitiesResult, typeResult] = await Promise.all([
     queryEntities(type, env2, {
       status: opts.status,
@@ -24051,12 +24187,12 @@ entitiesCommand.command("list <type>").description("List entities of a type").op
     queryEntityTypeBySlug(type, env2, orgId)
   ]);
   if (entitiesResult.error || !entitiesResult.data) {
-    spinner.fail(`Failed to fetch ${type} entities`);
+    spinner.fail(`Failed to fetch ${type} records`);
     console.log(source_default.red("Error:"), entitiesResult.error);
     process.exit(1);
   }
   const entities = entitiesResult.data;
-  spinner.succeed(`Found ${entities.length} ${type} entities`);
+  spinner.succeed(`Found ${entities.length} ${type} records`);
   if (opts.json) {
     console.log(JSON.stringify(entities, null, 2));
     return;
@@ -24069,27 +24205,27 @@ entitiesCommand.command("list <type>").description("List entities of a type").op
   renderTable(columns, entities.map(flattenEntityForTable));
   console.log();
 });
-entitiesCommand.command("get <id>").description("Get entity details").option("--env <environment>", "Environment (development|production)", "development").option("--json", "Output raw JSON").action(async (rawId, opts) => {
+entitiesCommand.command("get <id>").description("Get record details").option("--env <environment>", "Environment (development|production)", "development").option("--json", "Output raw JSON").action(async (rawId, opts) => {
   await ensureAuth();
   const spinner = ora();
   const env2 = opts.env;
   const orgId = getOrgId();
-  spinner.start("Resolving entity ID");
+  spinner.start("Resolving record ID");
   const resolved = await resolveEntityId(rawId, env2, orgId);
   if (resolved.error || !resolved.data) {
-    spinner.fail("Entity not found");
-    console.log(source_default.red("Error:"), resolved.error || `No entity matched "${rawId}"`);
+    spinner.fail("Record not found");
+    console.log(source_default.red("Error:"), resolved.error || `No record matched "${rawId}"`);
     process.exit(1);
   }
   const id = resolved.data;
-  spinner.text = "Fetching entity";
+  spinner.text = "Fetching record";
   const { data, error } = await queryEntity(id, env2, orgId);
   if (error || !data) {
-    spinner.fail("Failed to fetch entity");
-    console.log(source_default.red("Error:"), error || "Entity not found");
+    spinner.fail("Failed to fetch record");
+    console.log(source_default.red("Error:"), error || "Record not found");
     process.exit(1);
   }
-  spinner.succeed("Entity loaded");
+  spinner.succeed("Record loaded");
   const result = data;
   if (opts.json) {
     console.log(JSON.stringify(result, null, 2));
@@ -24117,7 +24253,7 @@ entitiesCommand.command("get <id>").description("Get entity details").option("--
   }
   console.log();
 });
-entitiesCommand.command("create <type>").description("Create a new entity").option("--env <environment>", "Environment (development|production)", "development").option("--data <json>", "Entity data as JSON").option("--status <status>", "Initial status").option("--json", "Output raw JSON").action(async (type, opts) => {
+entitiesCommand.command("create <type>").description("Create a new record").option("--env <environment>", "Environment (development|production)", "development").option("--data <json>", "Record data as JSON").option("--status <status>", "Initial status").option("--json", "Output raw JSON").action(async (type, opts) => {
   await ensureAuth();
   const spinner = ora();
   const env2 = opts.env;
@@ -24137,7 +24273,7 @@ entitiesCommand.command("create <type>").description("Create a new entity").opti
     spinner.start(`Fetching ${type} schema`);
     const { data: typeData, error: error2 } = await queryEntityTypeBySlug(type, env2, orgId);
     if (error2 || !typeData) {
-      spinner.fail(`Entity type not found: ${type}`);
+      spinner.fail(`Data type not found: ${type}`);
       console.log(source_default.red("Error:"), error2 || "Not found");
       process.exit(1);
     }
@@ -24146,7 +24282,7 @@ entitiesCommand.command("create <type>").description("Create a new entity").opti
     const entityType = typeData;
     const schema = entityType.schema;
     if (!schema?.properties) {
-      console.log(source_default.red("Entity type has no schema properties defined"));
+      console.log(source_default.red("Data type has no schema properties defined"));
       process.exit(1);
     }
     data = {};
@@ -24175,14 +24311,14 @@ entitiesCommand.command("create <type>").description("Create a new entity").opti
     }
     console.log();
   }
-  spinner.start(`Creating ${type} entity`);
+  spinner.start(`Creating ${type} record`);
   const { data: result, error } = await createEntity(type, data, env2, opts.status, orgId);
   if (error) {
-    spinner.fail("Failed to create entity");
+    spinner.fail("Failed to create record");
     console.log(source_default.red("Error:"), error);
     process.exit(1);
   }
-  spinner.succeed(`Entity created`);
+  spinner.succeed(`Record created`);
   if (opts.json) {
     console.log(JSON.stringify({ id: result }, null, 2));
   } else {
@@ -24191,7 +24327,7 @@ entitiesCommand.command("create <type>").description("Create a new entity").opti
     console.log();
   }
 });
-entitiesCommand.command("update <id>").description("Update an entity").option("--env <environment>", "Environment (development|production)", "development").option("--data <json>", "Update data as JSON").option("--status <status>", "New status").option("--json", "Output raw JSON").action(async (rawId, opts) => {
+entitiesCommand.command("update <id>").description("Update a record").option("--env <environment>", "Environment (development|production)", "development").option("--data <json>", "Update data as JSON").option("--status <status>", "New status").option("--json", "Output raw JSON").action(async (rawId, opts) => {
   await ensureAuth();
   const spinner = ora();
   const env2 = opts.env;
@@ -24209,63 +24345,63 @@ entitiesCommand.command("update <id>").description("Update an entity").option("-
       process.exit(1);
     }
   }
-  spinner.start("Resolving entity ID");
+  spinner.start("Resolving record ID");
   const resolved = await resolveEntityId(rawId, env2, orgId);
   if (resolved.error || !resolved.data) {
-    spinner.fail("Entity not found");
-    console.log(source_default.red("Error:"), resolved.error || `No entity matched "${rawId}"`);
+    spinner.fail("Record not found");
+    console.log(source_default.red("Error:"), resolved.error || `No record matched "${rawId}"`);
     process.exit(1);
   }
   const id = resolved.data;
-  spinner.text = "Updating entity";
+  spinner.text = "Updating record";
   const { data: result, error } = await updateEntity(id, data, env2, opts.status, orgId);
   if (error) {
-    spinner.fail("Failed to update entity");
+    spinner.fail("Failed to update record");
     console.log(source_default.red("Error:"), error);
     process.exit(1);
   }
-  spinner.succeed("Entity updated");
+  spinner.succeed("Record updated");
   if (opts.json) {
     console.log(JSON.stringify(result, null, 2));
   } else {
     console.log();
-    console.log(source_default.green("  Entity updated successfully"));
+    console.log(source_default.green("  Record updated successfully"));
     console.log();
   }
 });
-entitiesCommand.command("delete <id>").description("Delete an entity").option("--env <environment>", "Environment (development|production)", "development").option("--yes", "Skip confirmation").option("--json", "Output raw JSON").action(async (rawId, opts) => {
+entitiesCommand.command("delete <id>").description("Delete a record").option("--env <environment>", "Environment (development|production)", "development").option("--yes", "Skip confirmation").option("--json", "Output raw JSON").action(async (rawId, opts) => {
   await ensureAuth();
   const spinner = ora();
   const env2 = opts.env;
   const orgId = getOrgId();
   const jsonMode = !!opts.json;
   if (!jsonMode)
-    spinner.start("Resolving entity ID");
+    spinner.start("Resolving record ID");
   const resolved = await resolveEntityId(rawId, env2, orgId);
   if (resolved.error || !resolved.data) {
     if (jsonMode) {
-      console.log(JSON.stringify({ success: false, error: resolved.error || `No entity matched "${rawId}"` }));
+      console.log(JSON.stringify({ success: false, error: resolved.error || `No record matched "${rawId}"` }));
     } else {
-      spinner.fail("Entity not found");
-      console.log(source_default.red("Error:"), resolved.error || `No entity matched "${rawId}"`);
+      spinner.fail("Record not found");
+      console.log(source_default.red("Error:"), resolved.error || `No record matched "${rawId}"`);
     }
     process.exit(1);
   }
   const id = resolved.data;
   if (!jsonMode)
-    spinner.text = "Fetching entity";
+    spinner.text = "Fetching record";
   const { data, error: fetchError } = await queryEntity(id, env2, orgId);
   if (fetchError || !data) {
     if (jsonMode) {
-      console.log(JSON.stringify({ success: false, error: fetchError || "Entity not found" }));
+      console.log(JSON.stringify({ success: false, error: fetchError || "Record not found" }));
     } else {
-      spinner.fail("Failed to fetch entity");
-      console.log(source_default.red("Error:"), fetchError || "Entity not found");
+      spinner.fail("Failed to fetch record");
+      console.log(source_default.red("Error:"), fetchError || "Record not found");
     }
     process.exit(1);
   }
   if (!jsonMode)
-    spinner.succeed("Entity loaded");
+    spinner.succeed("Record loaded");
   const result = data;
   const entity = result.entity;
   const entityType = result.entityType;
@@ -24283,7 +24419,7 @@ entitiesCommand.command("delete <id>").description("Delete an entity").option("-
   }
   if (!opts.yes && !jsonMode && isInteractive2()) {
     const confirmed = await esm_default2({
-      message: "Are you sure you want to delete this entity?",
+      message: "Are you sure you want to delete this record?",
       default: false
     });
     if (!confirmed) {
@@ -24292,13 +24428,13 @@ entitiesCommand.command("delete <id>").description("Delete an entity").option("-
     }
   }
   if (!jsonMode)
-    spinner.start("Deleting entity");
+    spinner.start("Deleting record");
   const { error } = await removeEntity(id, env2, orgId);
   if (error) {
     if (jsonMode) {
       console.log(JSON.stringify({ success: false, error }));
     } else {
-      spinner.fail("Failed to delete entity");
+      spinner.fail("Failed to delete record");
       console.log(source_default.red("Error:"), error);
     }
     process.exit(1);
@@ -24306,11 +24442,11 @@ entitiesCommand.command("delete <id>").description("Delete an entity").option("-
   if (jsonMode) {
     console.log(JSON.stringify({ success: true, id }));
   } else {
-    spinner.succeed("Entity deleted");
+    spinner.succeed("Record deleted");
     console.log();
   }
 });
-entitiesCommand.command("search <type> <query>").description("Search entities").option("--env <environment>", "Environment (development|production)", "development").option("--limit <n>", "Maximum results", "25").option("--json", "Output raw JSON").action(async (type, query, opts) => {
+entitiesCommand.command("search <type> <query>").description("Search records").option("--env <environment>", "Environment (development|production)", "development").option("--limit <n>", "Maximum results", "25").option("--json", "Output raw JSON").action(async (type, query, opts) => {
   await ensureAuth();
   const spinner = ora();
   const env2 = opts.env;
@@ -25313,7 +25449,7 @@ async function setIntegrationStatus(provider, env2, status) {
 }
 
 // src/cli/commands/integration.ts
-var VALID_PROVIDERS = ["airtable", "resend"];
+var VALID_PROVIDERS = ["airtable", "resend", "flow"];
 async function ensureAuth3() {
   const cwd = process.cwd();
   const nonInteractive = !isInteractive2();
@@ -25366,6 +25502,8 @@ function getProviderHelp(provider) {
       return `Usage: struere integration airtable --token <pat> [--base-id <id>] [--test]`;
     case "resend":
       return `Usage: struere integration resend --from-email <email> [--from-name <name>] [--reply-to <email>]`;
+    case "flow":
+      return `Usage: struere integration flow --api-url <url> --api-key <key> --secret-key <secret> [--return-url <url>]`;
     default:
       return "";
   }
@@ -25393,9 +25531,23 @@ function buildConfigFromOpts(provider, opts) {
       return null;
     return config;
   }
+  if (provider === "flow") {
+    const config = {};
+    if (opts.apiUrl)
+      config.apiUrl = opts.apiUrl;
+    if (opts.apiKey)
+      config.apiKey = opts.apiKey;
+    if (opts.secretKey)
+      config.secretKey = opts.secretKey;
+    if (opts.returnUrl)
+      config.returnUrl = opts.returnUrl;
+    if (Object.keys(config).length === 0)
+      return null;
+    return config;
+  }
   return null;
 }
-var integrationCommand = new Command("integration").description("Manage integrations").argument("[provider]", "Integration provider (airtable, resend)").option("--env <environment>", "Environment (development|production)", "development").option("--token <pat>", "Personal access token (airtable)").option("--base-id <id>", "Default base ID (airtable)").option("--from-email <email>", "From email address (resend)").option("--from-name <name>", "From display name (resend)").option("--reply-to <email>", "Reply-to address (resend)").option("--test", "Test the connection after saving").option("--remove", "Remove integration config").option("--enable", "Enable integration").option("--disable", "Disable integration").option("--status", "Show current config status").option("--yes", "Skip confirmation prompts").option("--json", "Output raw JSON").action(async (provider, opts) => {
+var integrationCommand = new Command("integration").description("Manage integrations").argument("[provider]", "Integration provider (airtable, resend, flow)").option("--env <environment>", "Environment (development|production)", "development").option("--token <pat>", "Personal access token (airtable)").option("--base-id <id>", "Default base ID (airtable)").option("--from-email <email>", "From email address (resend)").option("--from-name <name>", "From display name (resend)").option("--reply-to <email>", "Reply-to address (resend)").option("--api-url <url>", "API URL (flow)").option("--api-key <key>", "API key (flow)").option("--secret-key <secret>", "Secret key (flow)").option("--return-url <url>", "Return URL after payment (flow)").option("--test", "Test the connection after saving").option("--remove", "Remove integration config").option("--enable", "Enable integration").option("--disable", "Disable integration").option("--status", "Show current config status").option("--yes", "Skip confirmation prompts").option("--json", "Output raw JSON").action(async (provider, opts) => {
   await ensureAuth3();
   const env2 = opts.env;
   const out = createOutput();
@@ -25570,10 +25722,154 @@ var integrationCommand = new Command("integration").description("Manage integrat
   }
   console.log();
 });
+
+// src/cli/commands/compile-prompt.ts
+var compilePromptCommand = new Command("compile-prompt").description("Compile and preview an agent's system prompt after template processing").argument("<agent-slug>", "Agent slug to compile prompt for").option("--env <env>", "Environment: development | production", "development").option("--message <msg>", "Sample message for template context").option("--channel <channel>", "Sample channel (whatsapp, widget, api, dashboard)").option("--param <key=value...>", "Custom thread param (repeatable)", (val, acc) => {
+  acc.push(val);
+  return acc;
+}, []).option("--json", "Output full JSON (raw + compiled + context)").option("--raw", "Show raw uncompiled template instead of compiled").action(async (agentSlug, options) => {
+  const spinner = ora();
+  const cwd = process.cwd();
+  const nonInteractive = !isInteractive2();
+  const jsonMode = !!options.json;
+  if (!hasProject(cwd)) {
+    if (nonInteractive) {
+      if (jsonMode) {
+        console.log(JSON.stringify({ success: false, error: "No struere.json found" }));
+      } else {
+        console.log(source_default.red("No struere.json found. Run struere init first."));
+      }
+      process.exit(1);
+    }
+    console.log(source_default.yellow("No struere.json found - initializing project..."));
+    console.log();
+    const success = await runInit(cwd);
+    if (!success) {
+      process.exit(1);
+    }
+    console.log();
+  }
+  const project = loadProject(cwd);
+  if (!project) {
+    if (jsonMode) {
+      console.log(JSON.stringify({ success: false, error: "Failed to load struere.json" }));
+    } else {
+      console.log(source_default.red("Failed to load struere.json"));
+    }
+    process.exit(1);
+  }
+  let credentials = loadCredentials();
+  const apiKey = getApiKey();
+  if (!credentials && !apiKey) {
+    if (nonInteractive) {
+      if (jsonMode) {
+        console.log(JSON.stringify({ success: false, error: "Not authenticated. Set STRUERE_API_KEY or run struere login." }));
+      } else {
+        console.log(source_default.red("Not authenticated. Set STRUERE_API_KEY or run struere login."));
+      }
+      process.exit(1);
+    }
+    console.log(source_default.yellow("Not logged in - authenticating..."));
+    console.log();
+    credentials = await performLogin();
+    if (!credentials) {
+      console.log(source_default.red("Authentication failed"));
+      process.exit(1);
+    }
+    console.log();
+  }
+  const threadMetadata = {};
+  for (const param of options.param) {
+    const eqIndex = param.indexOf("=");
+    if (eqIndex === -1) {
+      if (jsonMode) {
+        console.log(JSON.stringify({ success: false, error: `Invalid param format: ${param}. Use key=value.` }));
+      } else {
+        console.log(source_default.red(`Invalid param format: ${param}. Use key=value.`));
+      }
+      process.exit(1);
+    }
+    const key = param.slice(0, eqIndex);
+    const value = param.slice(eqIndex + 1);
+    threadMetadata[key] = value;
+  }
+  const environment = options.env;
+  if (!jsonMode) {
+    spinner.start(`Compiling prompt for ${source_default.cyan(agentSlug)} (${environment})`);
+  }
+  const doCompile = async () => {
+    return compilePrompt({
+      slug: agentSlug,
+      environment,
+      message: options.message,
+      channel: options.channel,
+      threadMetadata: Object.keys(threadMetadata).length > 0 ? threadMetadata : undefined
+    });
+  };
+  let { result, error } = await doCompile();
+  if (error && isAuthError(error) && !nonInteractive) {
+    if (!jsonMode)
+      spinner.fail("Session expired - re-authenticating...");
+    clearCredentials();
+    credentials = await performLogin();
+    if (!credentials) {
+      if (jsonMode) {
+        console.log(JSON.stringify({ success: false, error: "Authentication failed" }));
+      } else {
+        console.log(source_default.red("Authentication failed"));
+      }
+      process.exit(1);
+    }
+    const retry = await doCompile();
+    result = retry.result;
+    error = retry.error;
+    if (!jsonMode && !error)
+      spinner.succeed("Compiled prompt");
+  }
+  if (error) {
+    if (jsonMode) {
+      console.log(JSON.stringify({ success: false, error }));
+    } else {
+      spinner.fail("Failed to compile prompt");
+      console.log(source_default.red("Error:"), error);
+    }
+    process.exit(1);
+  }
+  if (!result) {
+    if (jsonMode) {
+      console.log(JSON.stringify({ success: false, error: "No result returned" }));
+    } else {
+      spinner.fail("No result returned");
+    }
+    process.exit(1);
+  }
+  if (!jsonMode)
+    spinner.succeed("Compiled prompt");
+  if (jsonMode) {
+    console.log(JSON.stringify({
+      success: true,
+      raw: result.raw,
+      compiled: result.compiled,
+      context: result.context
+    }, null, 2));
+  } else if (options.raw) {
+    console.log();
+    console.log(source_default.bold("Raw System Prompt"));
+    console.log(source_default.gray("\u2500".repeat(60)));
+    console.log(result.raw);
+    console.log(source_default.gray("\u2500".repeat(60)));
+  } else {
+    console.log();
+    console.log(source_default.bold("Compiled System Prompt"));
+    console.log(source_default.gray("\u2500".repeat(60)));
+    console.log(result.compiled);
+    console.log(source_default.gray("\u2500".repeat(60)));
+  }
+});
 // package.json
 var package_default = {
   name: "struere",
-  version: "0.9.6",
+  version: "0.9.7",
   description: "Build, test, and deploy AI agents",
   keywords: [
     "ai",
@@ -25688,4 +25984,5 @@ program.addCommand(docsCommand);
 program.addCommand(evalCommand);
 program.addCommand(templatesCommand);
 program.addCommand(integrationCommand);
+program.addCommand(compilePromptCommand);
 program.parse();