npm - @agent-native/core - Versions diffs - 0.96.0 → 0.97.0 - Mend

@agent-native/core 0.96.0 → 0.97.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (450) hide show

package/dist/triggers/actions.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/triggers/actions.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Framework-level agent actions for the automations system.\n \n These are registered as native tools (not template actions) so they're\n * available in every template. The agent uses them to create, list, and\n * manage automations from chat.\n \n All six operations are consolidated into a single `manage-automations` tool\n * with an `action` discriminator to keep the tool registry compact.\n /\n\nimport type { ActionEntry } from \"../agent/production-agent.js\";\nimport { listEvents } from \"../event-bus/index.js\";\nimport {\n resourceListAllOwners,\n resourcePut,\n resourceDelete,\n resourceGetByPath,\n SHARED_OWNER,\n} from \"../resources/store.js\";\nimport {\n parseTriggerFrontmatter,\n buildTriggerContent,\n refreshEventSubscriptions,\n} from \"./dispatcher.js\";\nimport type { TriggerFrontmatter } from \"./types.js\";\n\n/ ------------------------------------------------------------------ /\n/ Individual action handlers /\n/ ------------------------------------------------------------------ /\n\nasync function handleListEvents(): Promise<string> {\n const events = listEvents();\n if (events.length === 0) {\n return \"No events registered yet. Events are registered by integrations (mail, calendar, clips, etc.).\";\n }\n const lines = events.map((e) => {\n let schemaStr = \"\";\n try {\n const s = e.payloadSchema as any;\n if (s?._zod?.def?.shape) {\n const fields = Object.keys(s._zod.def.shape);\n schemaStr = ` Fields: ${fields.join(\", \")}`;\n }\n } catch {\n // ignore\n }\n const example = e.example\n ? `\\n Example: ${JSON.stringify(e.example)}`\n : \"\";\n return `- ${e.name}: ${e.description}${schemaStr}${example}`;\n });\n return lines.join(\"\\n\");\n}\n\nasync function handleList(\n args: Record<string, string>,\n getCurrentUser: () => string,\n): Promise<string> {\n const owner = getCurrentUser();\n const resources = await resourceListAllOwners(\"jobs/\");\n const triggers = resources\n .filter((r) => r.owner === owner \|\| r.owner === SHARED_OWNER)\n .filter((r) => r.path.endsWith(\".md\"))\n .map((r) => {\n const { meta, body } = parseTriggerFrontmatter(r.content);\n const name = r.path.replace(/^jobs\\//, \"\").replace(/\\.md$/, \"\");\n return { name, meta, body, owner: r.owner, id: r.id };\n })\n .filter((t) => {\n if (args.domain && t.meta.domain !== args.domain) return false;\n if (args.enabled_only === \"true\" && !t.meta.enabled) return false;\n return true;\n });\n\n if (triggers.length === 0) return \"No automations found.\";\n\n const lines = triggers.map((t) => {\n const type =\n t.meta.triggerType === \"event\"\n ? `on ${t.meta.event \|\| \"?\"}`\n : `cron: ${t.meta.schedule}`;\n const status = t.meta.enabled ? \"enabled\" : \"disabled\";\n const lastStatus = t.meta.lastStatus ? ` (last: ${t.meta.lastStatus})` : \"\";\n const condition = t.meta.condition\n ? `\\n Condition: \"${t.meta.condition}\"`\n : \"\";\n const domain = t.meta.domain ? ` [${t.meta.domain}]` : \"\";\n return `- ${t.name}${domain}: ${type} → ${t.meta.mode} (${status}${lastStatus})${condition}\\n Body: ${t.body.slice(0, 100)}${t.body.length > 100 ? \"...\" : \"\"}`;\n });\n return lines.join(\"\\n\\n\");\n}\n\nasync function handleDefine(\n args: Record<string, string>,\n getCurrentUser: () => string,\n): Promise<string> {\n const owner = getCurrentUser();\n const name = (args.name \|\| \"\").replace(/[^a-z0-9-]/g, \"-\");\n if (!name) return \"Error: name is required (lowercase, hyphens).\";\n\n const path = `jobs/${name}.md`;\n\n // Check if it already exists\n const existing = await resourceGetByPath(owner, path);\n if (existing) {\n return `Error: An automation named \"${name}\" already exists. Use a different name or delete the existing one first.`;\n }\n\n const triggerType = args.trigger_type === \"schedule\" ? \"schedule\" : \"event\";\n const meta: TriggerFrontmatter = {\n schedule: args.schedule \|\| \"\",\n enabled: true,\n triggerType,\n event: args.event \|\| undefined,\n condition: args.condition \|\| undefined,\n mode: args.mode === \"deterministic\" ? \"deterministic\" : \"agentic\",\n domain: args.domain \|\| undefined,\n createdBy: owner,\n runAs: \"creator\",\n };\n\n const content = buildTriggerContent(meta, args.body \|\| \"\");\n await resourcePut(owner, path, content);\n\n // Refresh event subscriptions so the new trigger is active immediately\n await refreshEventSubscriptions();\n\n const summary =\n triggerType === \"event\"\n ? `on ${meta.event \|\| \"?\"}${meta.condition ? ` when \"${meta.condition}\"` : \"\"}`\n : `on schedule \"${meta.schedule}\"`;\n\n return `Automation \"${name}\" created. Fires ${summary} in ${meta.mode} mode.`;\n}\n\nasync function handleUpdate(\n args: Record<string, string>,\n getCurrentUser: () => string,\n): Promise<string> {\n const owner = getCurrentUser();\n const name = args.name;\n const path = `jobs/${name}.md`;\n\n const resource = await resourceGetByPath(owner, path);\n if (!resource) {\n return `Automation \"${name}\" not found (or you don't own it).`;\n }\n\n const { meta, body } = parseTriggerFrontmatter(resource.content);\n\n if (args.enabled !== undefined) {\n meta.enabled = args.enabled !== \"false\";\n }\n if (args.condition !== undefined) {\n meta.condition = args.condition \|\| undefined;\n }\n const newBody = args.body ?? body;\n\n await resourcePut(\n resource.owner,\n resource.path,\n buildTriggerContent(meta, newBody),\n );\n await refreshEventSubscriptions();\n\n return `Automation \"${name}\" updated.`;\n}\n\nasync function handleDelete(\n args: Record<string, string>,\n getCurrentUser: () => string,\n): Promise<string> {\n const owner = getCurrentUser();\n const path = `jobs/${args.name}.md`;\n\n const resource = await resourceGetByPath(owner, path);\n if (!resource) return `Automation \"${args.name}\" not found.`;\n\n await resourceDelete(resource.id);\n return `Automation \"${args.name}\" deleted.`;\n}\n\nasync function handleFireTest(\n args: Record<string, string>,\n getCurrentUser: () => string,\n): Promise<string> {\n // Dynamic import to avoid circular dependency at module load time\n const { emit } = await import(\"../event-bus/index.js\");\n\n let data: Record<string, unknown> = {};\n if (args.data) {\n try {\n data = JSON.parse(args.data);\n } catch {\n return \"Error: invalid JSON in data parameter.\";\n }\n }\n\n // Scope the test event to the current user so only their automations fire,\n // not automations owned by other users in the same process.\n const owner = getCurrentUser();\n emit(\"test.event.fired\", { data }, { owner });\n return `Test event fired with payload: ${JSON.stringify({ data })}. Any automations subscribed to \"test.event.fired\" will be evaluated.`;\n}\n\n/ ------------------------------------------------------------------ /\n/ Consolidated tool entry /\n/ ------------------------------------------------------------------ /\n\nconst VALID_ACTIONS = [\n \"list-events\",\n \"list\",\n \"define\",\n \"update\",\n \"delete\",\n \"fire-test\",\n] as const;\n\nexport function createAutomationToolEntries(\n getCurrentUser: () => string,\n): Record<string, ActionEntry> {\n return {\n \"manage-automations\": {\n tool: {\n description: `Manage automations (event-triggered and scheduled tasks). Use the \"action\" parameter to choose an operation:\n\n- list-events: List all registered event types that automations can subscribe to. Returns event names, descriptions, and payload schemas. Call this BEFORE defining an automation to discover available events.\n- list: List all automations (triggers). Shows name, event, condition, mode, status, and domain. Optional params: domain, enabled_only.\n- define: Create a new automation. IMPORTANT: Always confirm with the user before calling — show them a summary of what will be created. Required params: name, trigger_type, body. Optional: event, schedule, condition, mode, domain.\n- update: Update an existing automation's settings (enabled, condition, body, etc.). Required param: name. Optional: enabled, condition, body.\n- delete: Delete an automation. Always confirm with the user first. Required param: name.\n- fire-test: Fire a test event to validate automations. Emits a test.event.fired event. Optional param: data (JSON string).`,\n parameters: {\n type: \"object\" as const,\n properties: {\n action: {\n type: \"string\",\n description:\n \"The operation to perform: list-events, list, define, update, delete, or fire-test.\",\n enum: [...VALID_ACTIONS],\n },\n name: {\n type: \"string\",\n description:\n \"Slug name for the automation (lowercase, hyphens). Used by define, update, and delete.\",\n },\n trigger_type: {\n type: \"string\",\n description: '\"event\" or \"schedule\". Required for define.',\n enum: [\"event\", \"schedule\"],\n },\n event: {\n type: \"string\",\n description:\n \"For event triggers: the event name to subscribe to. Call with action=list-events first to see available events.\",\n },\n schedule: {\n type: \"string\",\n description:\n 'For schedule triggers: cron expression. Example: \"0 9 * 1-5\" (9am weekdays).',\n },\n condition: {\n type: \"string\",\n description:\n 'Natural-language condition. Example: \"attendee email ends with @builder.io\". Leave empty for unconditional. Used by define and update.',\n },\n mode: {\n type: \"string\",\n description:\n '\"agentic\" (full agent loop, can use tools) or \"deterministic\" (fixed actions only). Used by define.',\n enum: [\"agentic\", \"deterministic\"],\n },\n domain: {\n type: \"string\",\n description:\n \"Domain tag for grouping (mail, calendar, clips, etc.). Used by define and list.\",\n },\n body: {\n type: \"string\",\n description:\n \"The natural-language instructions for what to do when the automation fires. This becomes the agent's prompt in agentic mode. Used by define and update.\",\n },\n enabled: {\n type: \"string\",\n description:\n '\"true\" or \"false\" to enable/disable. Used by update.',\n },\n enabled_only: {\n type: \"string\",\n description:\n '\"true\" to show only enabled automations. Used by list.',\n },\n data: {\n type: \"string\",\n description:\n 'JSON data to include as the test event payload. Used by fire-test. Example: \\'{\"email\": \"test@example.com\"}\\'.',\n },\n },\n required: [\"action\"],\n },\n },\n run: async (args: Record<string, string>) => {\n const action = args.action;\n\n switch (action) {\n case \"list-events\":\n return handleListEvents();\n case \"list\":\n return handleList(args, getCurrentUser);\n case \"define\":\n return handleDefine(args, getCurrentUser);\n case \"update\":\n return handleUpdate(args, getCurrentUser);\n case \"delete\":\n return handleDelete(args, getCurrentUser);\n case \"fire-test\":\n return handleFireTest(args, getCurrentUser);\n default:\n return `Error: unknown action \"${action}\". Valid actions: ${VALID_ACTIONS.join(\", \")}.`;\n }\n },\n },\n };\n}\n"]}
1	+ {"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/triggers/actions.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Framework-level agent actions for the automations system.\n \n These are registered as native tools (not template actions) so they're\n * available in every template. The agent uses them to create, list, and\n * manage automations from chat.\n \n All six operations are consolidated into a single `manage-automations` tool\n * with an `action` discriminator to keep the tool registry compact.\n /\n\nimport type { ActionEntry } from \"../agent/production-agent.js\";\nimport { listEvents } from \"../event-bus/index.js\";\nimport {\n resourceListAllOwners,\n resourcePut,\n resourceDelete,\n resourceGetByPath,\n SHARED_OWNER,\n} from \"../resources/store.js\";\nimport {\n parseTriggerFrontmatter,\n buildTriggerContent,\n refreshEventSubscriptions,\n} from \"./dispatcher.js\";\nimport type { TriggerFrontmatter } from \"./types.js\";\n\n/ ------------------------------------------------------------------ /\n/ Individual action handlers /\n/ ------------------------------------------------------------------ /\n\nasync function handleListEvents(): Promise<string> {\n const events = listEvents();\n if (events.length === 0) {\n return \"No events registered yet. Events are registered by integrations (mail, calendar, clips, etc.).\";\n }\n const lines = events.map((e) => {\n let schemaStr = \"\";\n try {\n const s = e.payloadSchema as any;\n if (s?._zod?.def?.shape) {\n const fields = Object.keys(s._zod.def.shape);\n schemaStr = ` Fields: ${fields.join(\", \")}`;\n }\n } catch {\n // ignore\n }\n const example = e.example\n ? `\\n Example: ${JSON.stringify(e.example)}`\n : \"\";\n return `- ${e.name}: ${e.description}${schemaStr}${example}`;\n });\n return lines.join(\"\\n\");\n}\n\nasync function handleList(\n args: Record<string, string>,\n getCurrentUser: () => string,\n): Promise<string> {\n const owner = getCurrentUser();\n const resources = await resourceListAllOwners(\"jobs/\");\n const triggers = resources\n .filter((r) => r.owner === owner \|\| r.owner === SHARED_OWNER)\n .filter((r) => r.path.endsWith(\".md\"))\n .map((r) => {\n const { meta, body } = parseTriggerFrontmatter(r.content);\n const name = r.path.replace(/^jobs\\//, \"\").replace(/\\.md$/, \"\");\n return { name, meta, body, owner: r.owner, id: r.id };\n })\n .filter((t) => {\n if (args.domain && t.meta.domain !== args.domain) return false;\n if (args.enabled_only === \"true\" && !t.meta.enabled) return false;\n return true;\n });\n\n if (triggers.length === 0) return \"No automations found.\";\n\n const lines = triggers.map((t) => {\n const type =\n t.meta.triggerType === \"event\"\n ? `on ${t.meta.event \|\| \"?\"}`\n : `cron: ${t.meta.schedule}`;\n const status = t.meta.enabled ? \"enabled\" : \"disabled\";\n const lastStatus = t.meta.lastStatus ? ` (last: ${t.meta.lastStatus})` : \"\";\n const condition = t.meta.condition\n ? `\\n Condition: \"${t.meta.condition}\"`\n : \"\";\n const domain = t.meta.domain ? ` [${t.meta.domain}]` : \"\";\n return `- ${t.name}${domain}: ${type} → ${t.meta.mode} (${status}${lastStatus})${condition}\\n Body: ${t.body.slice(0, 100)}${t.body.length > 100 ? \"...\" : \"\"}`;\n });\n return lines.join(\"\\n\\n\");\n}\n\nasync function handleDefine(\n args: Record<string, string>,\n getCurrentUser: () => string,\n): Promise<string> {\n const owner = getCurrentUser();\n const name = (args.name \|\| \"\").replace(/[^a-z0-9-]/g, \"-\");\n if (!name) return \"Error: name is required (lowercase, hyphens).\";\n\n const path = `jobs/${name}.md`;\n\n // Check if it already exists\n const existing = await resourceGetByPath(owner, path);\n if (existing) {\n return `Error: An automation named \"${name}\" already exists. Use a different name or delete the existing one first.`;\n }\n\n if (args.mode === \"deterministic\") {\n return (\n \"Error: Deterministic mode was removed — it was never implemented and \" +\n \"automations that set it never fired. Create the automation without \" +\n \"mode (agentic), and describe the exact fixed steps in the automation body.\"\n );\n }\n\n const triggerType = args.trigger_type === \"schedule\" ? \"schedule\" : \"event\";\n const meta: TriggerFrontmatter = {\n schedule: args.schedule \|\| \"\",\n enabled: true,\n triggerType,\n event: args.event \|\| undefined,\n condition: args.condition \|\| undefined,\n mode: \"agentic\",\n domain: args.domain \|\| undefined,\n createdBy: owner,\n runAs: \"creator\",\n };\n\n const content = buildTriggerContent(meta, args.body \|\| \"\");\n await resourcePut(owner, path, content);\n\n // Refresh event subscriptions so the new trigger is active immediately\n await refreshEventSubscriptions();\n\n const summary =\n triggerType === \"event\"\n ? `on ${meta.event \|\| \"?\"}${meta.condition ? ` when \"${meta.condition}\"` : \"\"}`\n : `on schedule \"${meta.schedule}\"`;\n\n return `Automation \"${name}\" created. Fires ${summary} in ${meta.mode} mode.`;\n}\n\nasync function handleUpdate(\n args: Record<string, string>,\n getCurrentUser: () => string,\n): Promise<string> {\n const owner = getCurrentUser();\n const name = args.name;\n const path = `jobs/${name}.md`;\n\n const resource = await resourceGetByPath(owner, path);\n if (!resource) {\n return `Automation \"${name}\" not found (or you don't own it).`;\n }\n\n const { meta, body } = parseTriggerFrontmatter(resource.content);\n\n if (args.enabled !== undefined) {\n meta.enabled = args.enabled !== \"false\";\n }\n if (args.condition !== undefined) {\n meta.condition = args.condition \|\| undefined;\n }\n const newBody = args.body ?? body;\n\n await resourcePut(\n resource.owner,\n resource.path,\n buildTriggerContent(meta, newBody),\n );\n await refreshEventSubscriptions();\n\n return `Automation \"${name}\" updated.`;\n}\n\nasync function handleDelete(\n args: Record<string, string>,\n getCurrentUser: () => string,\n): Promise<string> {\n const owner = getCurrentUser();\n const path = `jobs/${args.name}.md`;\n\n const resource = await resourceGetByPath(owner, path);\n if (!resource) return `Automation \"${args.name}\" not found.`;\n\n await resourceDelete(resource.id);\n return `Automation \"${args.name}\" deleted.`;\n}\n\nasync function handleFireTest(\n args: Record<string, string>,\n getCurrentUser: () => string,\n): Promise<string> {\n // Dynamic import to avoid circular dependency at module load time\n const { emit } = await import(\"../event-bus/index.js\");\n\n let data: Record<string, unknown> = {};\n if (args.data) {\n try {\n data = JSON.parse(args.data);\n } catch {\n return \"Error: invalid JSON in data parameter.\";\n }\n }\n\n // Scope the test event to the current user so only their automations fire,\n // not automations owned by other users in the same process.\n const owner = getCurrentUser();\n emit(\"test.event.fired\", { data }, { owner });\n return `Test event fired with payload: ${JSON.stringify({ data })}. Any automations subscribed to \"test.event.fired\" will be evaluated.`;\n}\n\n/ ------------------------------------------------------------------ /\n/ Consolidated tool entry /\n/ ------------------------------------------------------------------ /\n\nconst VALID_ACTIONS = [\n \"list-events\",\n \"list\",\n \"define\",\n \"update\",\n \"delete\",\n \"fire-test\",\n] as const;\n\nexport function createAutomationToolEntries(\n getCurrentUser: () => string,\n): Record<string, ActionEntry> {\n return {\n \"manage-automations\": {\n tool: {\n description: `Manage automations (event-triggered and scheduled tasks). Use the \"action\" parameter to choose an operation:\n\n- list-events: List all registered event types that automations can subscribe to. Returns event names, descriptions, and payload schemas. Call this BEFORE defining an automation to discover available events.\n- list: List all automations (triggers). Shows name, event, condition, mode, status, and domain. Optional params: domain, enabled_only.\n- define: Create a new automation. IMPORTANT: Always confirm with the user before calling — show them a summary of what will be created. Required params: name, trigger_type, body. Optional: event, schedule, condition, mode, domain.\n- update: Update an existing automation's settings (enabled, condition, body, etc.). Required param: name. Optional: enabled, condition, body.\n- delete: Delete an automation. Always confirm with the user first. Required param: name.\n- fire-test: Fire a test event to validate automations. Emits a test.event.fired event. Optional param: data (JSON string).`,\n parameters: {\n type: \"object\" as const,\n properties: {\n action: {\n type: \"string\",\n description:\n \"The operation to perform: list-events, list, define, update, delete, or fire-test.\",\n enum: [...VALID_ACTIONS],\n },\n name: {\n type: \"string\",\n description:\n \"Slug name for the automation (lowercase, hyphens). Used by define, update, and delete.\",\n },\n trigger_type: {\n type: \"string\",\n description: '\"event\" or \"schedule\". Required for define.',\n enum: [\"event\", \"schedule\"],\n },\n event: {\n type: \"string\",\n description:\n \"For event triggers: the event name to subscribe to. Call with action=list-events first to see available events.\",\n },\n schedule: {\n type: \"string\",\n description:\n 'For schedule triggers: cron expression. Example: \"0 9 * 1-5\" (9am weekdays).',\n },\n condition: {\n type: \"string\",\n description:\n 'Natural-language condition. Example: \"attendee email ends with @builder.io\". Leave empty for unconditional. Used by define and update.',\n },\n mode: {\n type: \"string\",\n description:\n '\"agentic\" (full agent loop, can use tools) — the only supported mode. Used by define.',\n enum: [\"agentic\"],\n },\n domain: {\n type: \"string\",\n description:\n \"Domain tag for grouping (mail, calendar, clips, etc.). Used by define and list.\",\n },\n body: {\n type: \"string\",\n description:\n \"The natural-language instructions for what to do when the automation fires. This becomes the agent's prompt in agentic mode. Used by define and update.\",\n },\n enabled: {\n type: \"string\",\n description:\n '\"true\" or \"false\" to enable/disable. Used by update.',\n },\n enabled_only: {\n type: \"string\",\n description:\n '\"true\" to show only enabled automations. Used by list.',\n },\n data: {\n type: \"string\",\n description:\n 'JSON data to include as the test event payload. Used by fire-test. Example: \\'{\"email\": \"test@example.com\"}\\'.',\n },\n },\n required: [\"action\"],\n },\n },\n run: async (args: Record<string, string>) => {\n const action = args.action;\n\n switch (action) {\n case \"list-events\":\n return handleListEvents();\n case \"list\":\n return handleList(args, getCurrentUser);\n case \"define\":\n return handleDefine(args, getCurrentUser);\n case \"update\":\n return handleUpdate(args, getCurrentUser);\n case \"delete\":\n return handleDelete(args, getCurrentUser);\n case \"fire-test\":\n return handleFireTest(args, getCurrentUser);\n default:\n return `Error: unknown action \"${action}\". Valid actions: ${VALID_ACTIONS.join(\", \")}.`;\n }\n },\n },\n };\n}\n"]}

package/dist/triggers/types.d.ts CHANGED Viewed

@@ -14,7 +14,13 @@ export interface TriggerFrontmatter {
     event?: string;
     /** Natural-language condition evaluated by Haiku before dispatch. */
     condition?: string;
-    /** "agentic" = full runAgentLoop. "deterministic" = fixed action set. */
+    /**
+     * "agentic" = full runAgentLoop; the only mode `manage-automations` will
+     * define/update going forward. "deterministic" was removed from the
+     * advertised surface (never implemented) and is legacy-only: rows created
+     * before the removal may still carry it, and the dispatcher's
+     * warn-and-skip branch keeps them inert by design — do not make them fire.
+     */
     mode: "agentic" | "deterministic";
     /** Domain tag for filtering in per-template UIs. */
     domain?: string;

package/dist/triggers/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/triggers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC;IAClC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB~~,yEAAyE~~;~~IACzE~~,IAAI,EAAE,SAAS,GAAG,eAAe,CAAC;IAClC,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/triggers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC;IAClC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,IAAI,EAAE,SAAS,GAAG,eAAe,CAAC;IAClC,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/triggers/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/triggers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/*\n Extended frontmatter for triggers (superset of JobFrontmatter).\n \n Stored as markdown resources under `jobs/` — reuses the same storage\n * and scheduler infrastructure. Event-triggered jobs are skipped by the\n * cron scheduler and dispatched by the event bus instead.\n /\n\nexport interface TriggerFrontmatter {\n schedule: string;\n enabled: boolean;\n /* \"schedule\" = cron-based (legacy jobs). \"event\" = fires on bus event. /\n triggerType: \"schedule\" \| \"event\";\n /* For event triggers: the event name to subscribe to. /\n event?: string;\n /* Natural-language condition evaluated by Haiku before dispatch. /\n condition?: string;\n /* \"agentic\" = full runAgentLoop. \"deterministic\" = ~~fixed~~ ~~action~~ ~~set.~~ /\n mode: \"agentic\" \| \"deterministic\";\n /* Domain tag for filtering in per-template UIs. */\n domain?: string;\n createdBy?: string;\n orgId?: string;\n runAs?: \"creator\" \| \"shared\";\n lastRun?: string;\n lastStatus?: \"success\" \| \"error\" \| \"running\" \| \"skipped\";\n lastError?: string;\n nextRun?: string;\n}\n\nexport interface TriggerDispatchContext {\n triggerName: string;\n triggerBody: string;\n meta: TriggerFrontmatter;\n eventPayload?: unknown;\n}\n"]}
1	+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/triggers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/*\n Extended frontmatter for triggers (superset of JobFrontmatter).\n \n Stored as markdown resources under `jobs/` — reuses the same storage\n * and scheduler infrastructure. Event-triggered jobs are skipped by the\n * cron scheduler and dispatched by the event bus instead.\n /\n\nexport interface TriggerFrontmatter {\n schedule: string;\n enabled: boolean;\n /* \"schedule\" = cron-based (legacy jobs). \"event\" = fires on bus event. /\n triggerType: \"schedule\" \| \"event\";\n /* For event triggers: the event name to subscribe to. /\n event?: string;\n /* Natural-language condition evaluated by Haiku before dispatch. /\n condition?: string;\n /\n \"agentic\" = full runAgentLoop; the only mode `manage-automations` will\n * define/update going forward. \"deterministic\" was removed from the\n * advertised surface (never implemented) and is legacy-only: rows created\n * before the removal may still carry it, and the dispatcher's\n * warn-and-skip branch keeps them inert by design — do not make them fire.\n /\n mode: \"agentic\" \| \"deterministic\";\n /* Domain tag for filtering in per-template UIs. */\n domain?: string;\n createdBy?: string;\n orgId?: string;\n runAs?: \"creator\" \| \"shared\";\n lastRun?: string;\n lastStatus?: \"success\" \| \"error\" \| \"running\" \| \"skipped\";\n lastError?: string;\n nextRun?: string;\n}\n\nexport interface TriggerDispatchContext {\n triggerName: string;\n triggerBody: string;\n meta: TriggerFrontmatter;\n eventPayload?: unknown;\n}\n"]}

package/docs/content/audit-log.mdx CHANGED Viewed

@@ -73,10 +73,11 @@ Everything in `audit` is optional. The minimum useful addition is `target: () =>
 ## Reading the trail {#reading}
-Two read actions are available to the agent **and** the frontend in every app, scoped in SQL to the caller — they never return another tenant's rows:
+Three read actions are available to the agent **and** the frontend in every app, scoped in SQL to the caller — they never return another tenant's rows:
 - **`list-audit-events`** — filter by `targetType` / `targetId`, `actorKind` (`agent` | `human` | `system`), `status`, `threadId` / `turnId`, `action`, `sinceMs`, and `limit`.
 - **`get-audit-event`** — one event by id, including its redacted input payload.
+- **`export-audit-events`** — bulk-export the trail as CSV or NDJSON instead of hand-paging `list-audit-events`, for offline compliance pulls. Takes the same filters as `list-audit-events` (minus `limit`) plus `format` (`csv` | `ndjson`, default `csv`) and `maxRows` (default 5000, hard cap 10000), and returns `{ content, rowCount, truncated, format }` — `truncated: true` means more rows matched than `maxRows` allowed. It's itself a sensitive read, audited via `audit: { onRead: true }`.
 Build an activity feed or a "who changed this" line by calling `list-audit-events` from the UI with `useActionQuery` — never hand-write a fetch to the audit table:

package/docs/content/automations.mdx CHANGED Viewed

@@ -114,13 +114,13 @@ The third path — writing the `jobs/<name>.md` file by hand via `resourcePut`
 Automations share every field in the [recurring-jobs frontmatter table](/docs/recurring-jobs#frontmatter). These additional fields control event triggers, conditions, and the execution mode:
-| Field         | Type                             | Default      | Description                                                                                                                                                  |
-| ------------- | -------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `triggerType` | `"schedule"` \| `"event"`        | `"schedule"` | How the automation fires                                                                                                                                     |
-| `event`       | string                           | _(optional)_ | Event name to subscribe to (event triggers only)                                                                                                             |
-| `condition`   | string                           | _(optional)_ | Natural-language condition evaluated before dispatch                                                                                                         |
-| `mode`        | `"agentic"` \| `"deterministic"` | `"agentic"`  | Full agent loop. (`"deterministic"` is reserved but not yet implemented — automations that set it are skipped. Use `"agentic"` for all current automations.) |
-| `domain`      | string                           | _(optional)_ | Grouping tag (mail, calendar, clips, etc.)                                                                                                                   |
+| Field         | Type                      | Default      | Description                                                                                                                                   |
+| ------------- | ------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | How the automation fires                                                                                                                      |
+| `event`       | string                    | _(optional)_ | Event name to subscribe to (event triggers only)                                                                                              |
+| `condition`   | string                    | _(optional)_ | Natural-language condition evaluated before dispatch                                                                                          |
+| `mode`        | `"agentic"`               | `"agentic"`  | Full agent loop (the only supported mode). `"deterministic"` was removed — it was never implemented, and automations that set it never fired. |
+| `domain`      | string                    | _(optional)_ | Grouping tag (mail, calendar, clips, etc.)                                                                                                    |
 For an event trigger, `schedule` is `""` (empty); for a schedule trigger it carries the cron expression. The dispatcher also writes the same managed `lastRun` / `lastStatus` / `lastError` fields the scheduler does, plus a `"skipped"` status when a condition evaluates to false.

package/docs/content/creating-templates.mdx CHANGED Viewed

@@ -528,4 +528,4 @@ workspace pointed at current build output.
 - [**Multi-App Workspace**](/docs/multi-app-workspace) — make the template fit
   naturally alongside sibling apps and Dispatch.
 - [**Templates**](/docs/cloneable-saas) — turn a template into a
-  publishable, monetizable product.
+  publishable product you can share and deploy.

package/docs/content/internationalization.mdx CHANGED Viewed

@@ -59,7 +59,8 @@ export const i18nCatalog = {
 Always bundle `en-US`. Dynamic-import non-English catalogs so users only
 download the active locale. The supported locale codes are `en-US`, `zh-CN`,
-`es-ES`, `fr-FR`, `de-DE`, `ja-JP`, `ko-KR`, `pt-BR`, `hi-IN`, and `ar-SA`.
+`zh-TW`, `es-ES`, `fr-FR`, `de-DE`, `ja-JP`, `ko-KR`, `pt-BR`, `hi-IN`, and
+`ar-SA`.
 ## UI

package/docs/content/locales/ar-SA/audit-log.mdx CHANGED Viewed

@@ -73,10 +73,11 @@ export default defineAction({
 ## قراءة المسار {#reading}
-تتوفر قراءتان actions للوكيل **و** الواجهة الأمامية في كل تطبيق، ويتم تحديد نطاقهما في SQL للمتصل - ولا يُرجعان أبدًا صفوف مستأجر آخر:
+تتوفر ثلاث قراءات actions للوكيل **و** الواجهة الأمامية في كل تطبيق، ويتم تحديد نطاقها في SQL للمتصل - ولا تُرجع أبدًا صفوف مستأجر آخر:
 - **`list-audit-events`** — التصفية حسب `targetType` / `targetId`، `actorKind` (`agent` | `human` | `system`)، `status`، `threadId` / `turnId`، `action`، `sinceMs`، و`limit`.
 - **`get-audit-event`** — حدث واحد حسب المعرف، بما في ذلك حمولة الإدخال المنقحة الخاصة به.
+- **`export-audit-events`** — تصدير السجل بالجملة بصيغة CSV أو NDJSON بدلاً من ترقيم `list-audit-events` يدويًا، لعمليات السحب دون اتصال لأغراض الامتثال. تأخذ نفس عوامل تصفية `list-audit-events` (بدون `limit`) بالإضافة إلى `format` (`csv` | `ndjson`، الافتراضي `csv`) و`maxRows` (الافتراضي 5000، الحد الأقصى 10000)، وتُرجع `{ content, rowCount, truncated, format }` — تعني `truncated: true` أن عدد الصفوف المطابقة تجاوز `maxRows`. وهي نفسها قراءة حساسة، يتم تدقيقها عبر `audit: { onRead: true }`.
 أنشئ خلاصة نشاط أو سطر "من قام بتغيير هذا" عن طريق استدعاء `list-audit-events` من UI باستخدام `useActionQuery` — لا تكتب أبدًا يدويًا أي جلب إلى جدول التدقيق:

package/docs/content/locales/ar-SA/automations.mdx CHANGED Viewed

@@ -114,13 +114,13 @@ description: "عمليات التشغيل التلقائي المجدولة وا
 تشارك عمليات التشغيل الآلي كل حقل في [recurring-jobs frontmatter table](/docs/recurring-jobs#frontmatter). تتحكم هذه الحقول الإضافية في مشغلات الأحداث وشروطها ووضع التنفيذ:
-| الحقل         | اكتب                             | الافتراضي    | الوصف                                                                                                                                                               |
-| ------------- | -------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `triggerType` | `"schedule"` \| `"event"`        | `"schedule"` | كيفية تشغيل الأتمتة                                                                                                                                                 |
-| `event`       | سلسلة                            | _(اختياري)_  | اسم الحدث المطلوب الاشتراك فيه (مشغّلات الحدث فقط)                                                                                                                  |
-| `condition`   | سلسلة                            | _(اختياري)_  | تم تقييم حالة اللغة الطبيعية قبل الإرسال                                                                                                                            |
-| `mode`        | `"agentic"` \| `"deterministic"` | `"agentic"`  | حلقة الوكيل الكاملة. (`"deterministic"` محجوز ولكن لم يتم تنفيذه بعد — يتم تخطي عمليات الأتمتة التي تقوم بتعيينه. استخدم `"agentic"` لجميع عمليات الأتمتة الحالية.) |
-| `domain`      | سلسلة                            | _(اختياري)_  | علامة التجميع (البريد، التقويم، المقاطع, إلخ.)                                                                                                                      |
+| الحقل         | اكتب                      | الافتراضي    | الوصف                                                                                                                                  |
+| ------------- | ------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | كيفية تشغيل الأتمتة                                                                                                                    |
+| `event`       | سلسلة                     | _(اختياري)_  | اسم الحدث المطلوب الاشتراك فيه (مشغّلات الحدث فقط)                                                                                     |
+| `condition`   | سلسلة                     | _(اختياري)_  | تم تقييم حالة اللغة الطبيعية قبل الإرسال                                                                                               |
+| `mode`        | `"agentic"`               | `"agentic"`  | حلقة الوكيل الكاملة (الوضع الوحيد المدعوم). تمت إزالة `"deterministic"` — لم يتم تنفيذه قط، وعمليات الأتمتة التي تحدده لم تُطلق أبدًا. |
+| `domain`      | سلسلة                     | _(اختياري)_  | علامة التجميع (البريد، التقويم، المقاطع, إلخ.)                                                                                         |
 بالنسبة لمشغل الحدث، `schedule` هو `""` (فارغ)؛ بالنسبة لمشغل الجدول الزمني فإنه يحمل تعبير cron. يكتب المرسل أيضًا نفس حقول `lastRun` / `lastStatus` / `lastError` المُدارة التي يكتبها المجدول، بالإضافة إلى حالة `"skipped"` عندما يتم تقييم الشرط إلى خطأ.

package/docs/content/locales/ar-SA/getting-started.mdx CHANGED Viewed

@@ -163,7 +163,13 @@ export const responseInsights = table("response_insights", {
   />
 </WireframeBlock>
-وسع `view-screen` و `navigate` كي يعرف agent المسار الحالي ويستطيع فتح `/response-insights`. يمكن للنتائج أيضًا تضمين `href: "/response-insights"` لعرض زر "افتح رؤى الردود" في الدردشة.
+## 6. دع agent يتنقل {#agent-navigation}
+يتضمن قالب Chat action من نوع `view-screen` و `navigate`. وسّعهما مع نمو تطبيقك:
+- يجب أن يقرأ `view-screen` حالة التطبيق ويُعيد المسار الحالي، والرؤية المحددة، والفلاتر النشطة، وأي سياق صفحة مضغوط يحتاجه agent.
+- يجب أن يكتب `navigate` مسارًا من نفس الأصل مثل `/response-insights` عندما يقرر agent أن على المستخدم معاينة النتيجة بصريًا.
+- يمكن لنتائج action تضمين روابط مثل `href: "/response-insights"` كي تعرض الدردشة زر "افتح رؤى الردود" بشكل صريح.
 عندما تفتح الدردشة الكاملة صفحة تطبيق، استخدم `AgentChatSurface` و `AgentSidebar` و `useAgentChatHomeHandoff` و `useAgentChatHomeHandoffLinks` و `chatViewTransition` من [Agent Surfaces](/docs/agent-surfaces#rich-chat) كي تنتقل الدردشة إلى اللوحة الجانبية مع الحفاظ على نفس thread.

package/docs/content/locales/ar-SA/internationalization.mdx CHANGED Viewed

@@ -59,7 +59,7 @@ export const i18nCatalog = {
 ```
 حزمة `en-US` دائمًا. يتم استيراد الكتالوجات غير الإنجليزية بشكل ديناميكي للمستخدمين فقط
-قم بتنزيل اللغة النشطة. الرموز المحلية المدعومة هي `en-US`، `zh-CN`،
+قم بتنزيل اللغة النشطة. الرموز المحلية المدعومة هي `en-US`، `zh-CN`، `zh-TW`،
 `es-ES`، و`fr-FR`، و`de-DE`، و`ja-JP`، و`ko-KR`، و`pt-BR`، و`hi-IN`، و`ar-SA`.
 ## UI

package/docs/content/locales/ar-SA/package-lifecycle.mdx ADDED Viewed

@@ -0,0 +1,19 @@
+---
+title: دورة حياة الحزم
+description: فحص حزم Agent Native المعتمدة على بيان وإضافتها وإخراجها بأمان.
+---
+# دورة حياة الحزم
+يمكن للحزم القابلة لإعادة الاستخدام نشر ملف `agent-native.package.json` ثابت ذي
+إصدار. تقرأ أداة CLI ملف JSON فقط أثناء الفحص ولا تشغّل شيفرة الحزمة.
+```bash
+agent-native package inspect @agent-native/scheduling --json
+agent-native package add @agent-native/scheduling --apply
+agent-native package eject @agent-native/scheduling --apply
+```
+الإضافة والإخراج معاينة افتراضيًا. يسمح `--apply` بالكتابة وتشغيل مدير الحزم. ترفض
+الأداة التعارضات والتخطيطات غير المعروفة، وتستعيد الملفات وملفات القفل عند فشل التثبيت.
+يدعم الإصدار التجريبي إخراج Scheduling فقط، بينما يبقى Pinpoint مؤجلاً.

package/docs/content/locales/ar-SA/sandbox-adapters.mdx CHANGED Viewed

@@ -103,6 +103,10 @@ search: "المحولات، محول وضع الحماية، محول cli، رم
       path: "index.ts",
       note: "الاختيار: getSandboxAdapter() / registerSandboxAdapter()",
     },
+    {
+      path: "background.ts",
+      note: "علامة قائمة الانتظار الدائمة ودورة حياة التنفيذ في الخلفية",
+    },
     {
       path: "local-child-process-adapter.ts",
       note: "ال backend الافتراضي: Node child process مقيد",
@@ -183,12 +187,17 @@ registerSandboxAdapter(adapter)  →  AGENT_NATIVE_SANDBOX  →  local default
 ### `AGENT_NATIVE_SANDBOX` env var {#env}
-يحدد المحول المضمن حسب المعرف. حاليًا يتم توصيل `local` (الافتراضي) فقط؛ تعود القيم غير المعروفة إلى المستوى المحلي بدلاً من فشل التشغيل.
+يحدد محولًا مضمنًا حسب المعرف. كل من `local` (الافتراضي) و`background` موصولان؛ تعود القيم غير المعروفة إلى `local` بدلاً من فشل التشغيل.
 ```bash
-AGENT_NATIVE_SANDBOX=local   # الافتراضي — صريح
+AGENT_NATIVE_SANDBOX=local        # الافتراضي — صريح
+AGENT_NATIVE_SANDBOX=background   # وضع كل استدعاء run-code في قائمة انتظار دائمة
 ```
+يخزن `background` التعليمة البرمجية الأولية في `sandbox_executions` ويعيد فورًا `executionId` مع `status: "queued"`. يبدأ الإرسال الذاتي الموقّع استدعاءً جديدًا في بيئة serverless؛ ويبدأ Node طويل العمر عملاً منفصلًا داخل العملية؛ وتعيد عملية التحقق من الحالة والمسح الدوري تشغيل الإرسالات المفقودة أو عقود الإيجار المنتهية. تحقّق من التنفيذ لاحقًا للحصول على النتيجة المحفوظة.
+`BackgroundQueueAdapter` هو علامة لقائمة انتظار دائمة، وليس المنفذ. يستخدم العمل الموجود في قائمة الانتظار محول تنفيذ مسجلًا غير قائم على قائمة الانتظار عند توفره؛ وإلا فإنه يعود إلى عملية Node الفرعية المحلية. لا يوفر تحديد `background` وحده عزلاً عن بُعد أو داخل حاوية، ولا يجعل وقت تشغيل edge متوافقًا مع `node:child_process`.
 ### `registerSandboxAdapter()` {#register}
 تتجاوز العملية المضيفة الواجهة الخلفية لجميع استدعاءات `run-code` اللاحقة من خلال `index.ts` الخاص بالوصلة - على سبيل المثال، لتشغيل كل استدعاء في حاوية بعيدة:
@@ -213,13 +222,15 @@ registerSandboxAdapter(new RemoteSandboxAdapter());
 ## التماس لعداء متين {#durable}
-هذه الواجهة هي بمثابة التماس لصندوق الحماية البعيد/المتين في المستقبل. سيقوم المحول البعيد أو المتين (Docker، أو مشغل نمط Vercel-Sandbox، أو عامل الخلفية في قائمة الانتظار):
+يوفر المحول المضمن `background` بالفعل قائمة انتظار دائمة وميزانية تنفيذ جديدة، بينما يظل التنفيذ الفعلي مستخدمًا لمحول غير قائم على قائمة الانتظار أو للعملية الفرعية المحلية الاحتياطية. يمكن لمحول بعيد أو معزول مسجل بشكل منفصل (Docker أو مشغل بنمط Vercel-Sandbox) توفير حدود تنفيذ مختلفة وتنفيذ العمل في الخلفية لكل استدعاء أيضًا.
+مثل هذا المحول سوف:
-1. تنفيذ `SandboxAdapter.run` في وقت التشغيل خارج العملية.
-2. قم بتوصيل جسر الاسترجاع (أو مكالمات الجسر الوكيل إلى الأصل).
-3. السماح بتشغيل مهام البيانات الكبيرة حتى الاكتمال بشكل مستقل عن دورة حياة الطلب - بما يتجاوز الحد الأقصى المستضاف لبرنامج تنفيذ التعليمات البرمجية الذي يبلغ حوالي 40 ثانية والذي يحد محول العملية الفرعية المحلي.
+1. ينفذ `SandboxAdapter.run` في وقت تشغيل خارج العملية.
+2. ينشئ نفقًا لجسر loopback (أو يعيد توجيه استدعاءات الجسر إلى العملية الأصلية).
+3. يوفر عزلاً عن بُعد أو داخل حاوية بشكل مستقل عن دورة حياة قائمة الانتظار الدائمة المشحونة.
-قم بتسجيله تحت قيمة `AGENT_NATIVE_SANDBOX` جديدة (على سبيل المثال، `remote`) و/أو عبر `registerSandboxAdapter()`. لا تتغير حلقة الوكيل و`run-code.ts` أبدًا.
+سجله برمجيًا عبر `registerSandboxAdapter()`. لا تحتاج حلقة الوكيل و`run-code.ts` إلى التغيير.
 > [!TIP]
 > يُصدر مخطط `agent-native add sandbox docker` وصفة كاملة ومكتفية ذاتيًا لتنفيذ محول Docker مقابل هذا التماس. انظر [Blueprint Installer](/docs/blueprint-installer).

package/docs/content/locales/ar-SA/security.mdx CHANGED Viewed

@@ -415,3 +415,11 @@ AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK=1
 ```
 لا تزال عمليات الكتابة السرية لنطاق مساحة العمل تتطلب دور مالك/مسؤول المؤسسة بغض النظر عن هذه العلامة.
+## الخطوات التالية
+- [**Authentication**](/docs/authentication) — أوضاع المصادقة، ونطاقات الكوكيز (cookie)، وتفاصيل الجلسة التي تُبنى عليها هذه الصفحة
+- [**Multi-Tenancy**](/docs/multi-tenancy) — نموذج عضوية المؤسسة وراء تحديد النطاق بـ `org_id`
+- [**Sharing**](/docs/sharing) — نمط `ownableColumns()` وحارس الوصول المُطبَّق على الموارد القابلة للمشاركة
+- [**Messaging**](/docs/messaging#env-vars) — أسرار توقيع webhook لكل تكامل، المُشار إليها في قائمة التحقق أعلاه
+- [**Deployment**](/docs/deployment) — متغيرات بيئة الإنتاج التي تفترض قائمة التحقق هذه أنها مُعيَّنة

package/docs/content/locales/de-DE/audit-log.mdx CHANGED Viewed

@@ -73,10 +73,11 @@ Alles in `audit` ist optional. Der minimale nützliche Zusatz ist `target: () =>
 ## Die Spur lesen {#reading}
-Zwei gelesene actions stehen dem Agenten **und** dem Frontend in jeder App zur Verfügung, in SQL auf den Anrufer beschränkt – sie geben niemals die Zeilen eines anderen Mandanten zurück:
+Drei gelesene actions stehen dem Agenten **und** dem Frontend in jeder App zur Verfügung, in SQL auf den Anrufer beschränkt – sie geben niemals die Zeilen eines anderen Mandanten zurück:
 - **`list-audit-events`** – Filter nach `targetType` / `targetId`, `actorKind` (`agent` | `human` | `system`), `status`, `threadId` / `turnId`, `action`, `sinceMs` und `limit`.
 - **`get-audit-event`** – ein Ereignis nach ID, einschließlich seiner redigierten Eingabenutzlast.
+- **`export-audit-events`** – exportiert die Spur gesammelt als CSV oder NDJSON statt `list-audit-events` manuell zu paginieren, für Offline-Compliance-Abzüge. Nimmt dieselben Filter wie `list-audit-events` (ohne `limit`) sowie `format` (`csv` | `ndjson`, Standard `csv`) und `maxRows` (Standard 5000, harte Obergrenze 10000) und liefert `{ content, rowCount, truncated, format }` zurück – `truncated: true` bedeutet, dass mehr Zeilen übereinstimmten, als `maxRows` erlaubte. Es ist selbst ein sensibler Lesevorgang, geprüft über `audit: { onRead: true }`.
 Erstellen Sie einen Aktivitäts-Feed oder eine „Wer hat das geändert“-Zeile, indem Sie `list-audit-events` vom UI mit `useActionQuery` aufrufen – schreiben Sie niemals einen Abruf in die Prüftabelle von Hand:

package/docs/content/locales/de-DE/automations.mdx CHANGED Viewed

@@ -114,13 +114,13 @@ Der dritte Pfad – das manuelle Schreiben der `jobs/<name>.md`-Datei über `res
 Automatisierungen teilen sich jedes Feld im [recurring-jobs frontmatter table](/docs/recurring-jobs#frontmatter). Diese zusätzlichen Felder steuern Ereignisauslöser, Bedingungen und den Ausführungsmodus:
-| Feld          | Typ                              | Standard     | Beschreibung                                                                                                                                                                                                                |
-| ------------- | -------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `triggerType` | `"schedule"` \| `"event"`        | `"schedule"` | Wie die Automatisierung ausgelöst wird                                                                                                                                                                                      |
-| `event`       | Zeichenfolge                     | _(optional)_ | Ereignisname zum Abonnieren (nur Ereignisauslöser)                                                                                                                                                                          |
-| `condition`   | Zeichenfolge                     | _(optional)_ | Zustand in natürlicher Sprache wird vor dem Versand ausgewertet                                                                                                                                                             |
-| `mode`        | `"agentic"` \| `"deterministic"` | `"agentic"`  | Vollständige Agentenschleife. (`"deterministic"` ist reserviert, aber noch nicht implementiert – Automatisierungen, die es festlegen, werden übersprungen. Verwenden Sie `"agentic"` für alle aktuellen Automatisierungen.) |
-| `domain`      | Zeichenfolge                     | _(optional)_ | Gruppierungs-Tag (E-Mail, Kalender, Clips usw.)                                                                                                                                                                             |
+| Feld          | Typ                       | Standard     | Beschreibung                                                                                                                                                                                  |
+| ------------- | ------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | Wie die Automatisierung ausgelöst wird                                                                                                                                                        |
+| `event`       | Zeichenfolge              | _(optional)_ | Ereignisname zum Abonnieren (nur Ereignisauslöser)                                                                                                                                            |
+| `condition`   | Zeichenfolge              | _(optional)_ | Zustand in natürlicher Sprache wird vor dem Versand ausgewertet                                                                                                                               |
+| `mode`        | `"agentic"`               | `"agentic"`  | Vollständige Agentenschleife (der einzige unterstützte Modus). `"deterministic"` wurde entfernt – es wurde nie implementiert, und Automatisierungen, die es festlegten, wurden nie ausgelöst. |
+| `domain`      | Zeichenfolge              | _(optional)_ | Gruppierungs-Tag (E-Mail, Kalender, Clips usw.)                                                                                                                                               |
 Für einen Ereignisauslöser ist `schedule` `""` (leer); Für einen Zeitplanauslöser trägt es den Cron-Ausdruck. Der Dispatcher schreibt außerdem dieselben verwalteten `lastRun`-/`lastStatus`-/`lastError`-Felder wie der Scheduler, plus einen `"skipped"`-Status, wenn eine Bedingung als „falsch“ ausgewertet wird.

package/docs/content/locales/de-DE/getting-started.mdx CHANGED Viewed

@@ -163,7 +163,13 @@ Fügen Sie eine Route `/response-insights` mit `useActionQuery("list-response-in
   />
 </WireframeBlock>
-Erweitern Sie `view-screen` und `navigate`, damit der Agent die aktuelle Route kennt und `/response-insights` öffnen kann. Ergebnisse können außerdem `href: "/response-insights"` enthalten, um im Chat einen Button "Antwort-Insights öffnen" zu zeigen.
+## 6. Agent navigieren lassen {#agent-navigation}
+Die Chat-Vorlage enthält die actions `view-screen` und `navigate`. Erweitern Sie sie, wenn Ihre App wächst:
+- `view-screen` sollte den application state lesen und die aktuelle Route, das ausgewählte Insight, aktive Filter und jeden knappen Seitenkontext zurückgeben, den der Agent braucht.
+- `navigate` sollte einen same-origin Pfad wie `/response-insights` schreiben, wenn der Agent entscheidet, dass der Nutzer das Ergebnis visuell prüfen soll.
+- Action-Ergebnisse können Links wie `href: "/response-insights"` enthalten, damit der Chat einen expliziten Button „Antwort-Insights öffnen“ anbieten kann.
 Wenn der Vollseiten-Chat eine App-Seite öffnet, verwenden Sie `AgentChatSurface`, `AgentSidebar`, `useAgentChatHomeHandoff`, `useAgentChatHomeHandoffLinks` und `chatViewTransition` aus [Agent Surfaces](/docs/agent-surfaces#rich-chat), damit der Chat in die Seitenleiste gleitet und derselbe Thread erhalten bleibt.

package/docs/content/locales/de-DE/internationalization.mdx CHANGED Viewed

@@ -59,7 +59,7 @@ export const i18nCatalog = {
 ```
 Always bundle `en-US`. Dynamic-import non-English catalogs so users only
-Laden Sie das aktive Gebietsschema herunter. Die unterstützten Gebietsschemacodes sind `en-US`, `zh-CN`,
+Laden Sie das aktive Gebietsschema herunter. Die unterstützten Gebietsschemacodes sind `en-US`, `zh-CN`, `zh-TW`,
 `es-ES`, `fr-FR`, `de-DE`, `ja-JP`, `ko-KR`, `pt-BR`, `hi-IN` und `ar-SA`.
 ## UI

package/docs/content/locales/de-DE/package-lifecycle.mdx ADDED Viewed

@@ -0,0 +1,22 @@
+---
+title: Paketlebenszyklus
+description: Manifestgesteuerte Agent-Native-Pakete sicher prüfen, hinzufügen und auswerfen.
+---
+# Paketlebenszyklus
+Wiederverwendbare Pakete können ein statisches, versioniertes
+`agent-native.package.json` veröffentlichen. Die CLI liest nur diese JSON-Datei
+und führt beim Prüfen keinen Paketcode aus.
+```bash
+agent-native package inspect @agent-native/scheduling --json
+agent-native package add @agent-native/scheduling --apply
+agent-native package eject @agent-native/scheduling --apply
+```
+Hinzufügen und Auswerfen sind standardmäßig Vorschauen. Erst `--apply` schreibt
+Dateien und startet den erkannten Paketmanager. Kollisionen und unbekannte
+Layouts werden abgelehnt; bei einem Installationsfehler werden Dateien und
+Lockdateien zurückgesetzt. Zunächst unterstützt nur Scheduling das Auswerfen;
+Pinpoint bleibt bis nach dem Pilotprojekt zurückgestellt.

package/docs/content/locales/de-DE/sandbox-adapters.mdx CHANGED Viewed

@@ -103,6 +103,10 @@ Die Naht befindet sich im Kern bei `packages/core/src/coding-tools/sandbox/` –
       path: "index.ts",
       note: "Auswahl: getSandboxAdapter() / registerSandboxAdapter()",
     },
+    {
+      path: "background.ts",
+      note: "Marker für die dauerhafte Warteschlange und Lebenszyklus der Hintergrundausführung",
+    },
     {
       path: "local-child-process-adapter.ts",
       note: "Das Standard-Backend: gesperrter Node-Child-Prozess",
@@ -183,12 +187,17 @@ registerSandboxAdapter(adapter)  →  AGENT_NATIVE_SANDBOX  →  local default
 ### `AGENT_NATIVE_SANDBOX` Umgebungsvariable {#env}
-Wählt einen integrierten Adapter anhand der ID aus. Derzeit ist nur `local` (Standard) verkabelt; Bei unbekannten Werten wird auf lokal zurückgegriffen, anstatt dass die Ausführung fehlschlägt.
+Wählt einen integrierten Adapter anhand der ID aus. Sowohl `local` (Standard) als auch `background` sind eingebunden; unbekannte Werte fallen auf `local` zurück, statt die Ausführung fehlschlagen zu lassen.
 ```bash
-AGENT_NATIVE_SANDBOX=local   # die Standardeinstellung – explizit
+AGENT_NATIVE_SANDBOX=local        # die Standardeinstellung – explizit
+AGENT_NATIVE_SANDBOX=background   # jeden run-code-Aufruf dauerhaft einreihen
 ```
+`background` speichert den Rohcode in `sandbox_executions` und gibt sofort eine `executionId` mit `status: "queued"` zurück. Ein signierter Self-Dispatch startet einen neuen Serverless-Aufruf; langlebiges Node startet abgekoppelte Arbeit im Prozess; Statusabfragen und der periodische Sweep treiben verlorene Dispatches oder abgelaufene Leases erneut an. Das gespeicherte Ergebnis wird später durch Abfragen der Ausführung gelesen.
+`BackgroundQueueAdapter` ist ein Marker für die dauerhafte Warteschlange, nicht der Executor. Eingereihte Arbeit verwendet einen registrierten, nicht warteschlangenbasierten Ausführungsadapter, falls vorhanden; andernfalls fällt sie auf den lokalen Child-Prozess zurück. `background` allein bietet keine Remote- oder Container-Isolation und macht eine Edge-Laufzeit nicht mit `node:child_process` kompatibel.
 ### `registerSandboxAdapter()` {#register}
 Ein Hostprozess überschreibt das Backend für alle nachfolgenden `run-code`-Aufrufe über den `index.ts` der Seam – zum Beispiel, um jeden Aufruf in einem Remote-Container auszuführen:
@@ -213,13 +222,15 @@ registerSandboxAdapter(new RemoteSandboxAdapter());
 ## Die Naht für einen langlebigen Läufer {#durable}
-Diese Schnittstelle ist bewusst die Nahtstelle für eine zukünftige Remote-/dauerhafte Sandbox. Ein Remote- oder dauerhafter Adapter (Docker, ein Läufer im Vercel-Sandbox-Stil oder ein Hintergrundarbeiter in der Warteschlange) würde:
+Der integrierte Adapter `background` bietet bereits dauerhafte Einreihung und ein neues Ausführungsbudget, während die eigentliche Ausführung weiterhin einen nicht warteschlangenbasierten Adapter oder den lokalen Child-Prozess als Fallback verwendet. Ein separat registrierter Remote- oder isolierter Adapter (Docker oder ein Vercel-Sandbox-artiger Runner) kann eine andere Ausführungsgrenze bereitstellen und auch Hintergrundarbeit pro Aufruf ausführen.
+Ein solcher Adapter würde:
-1. Implementieren Sie `SandboxAdapter.run` gegen eine Out-of-Process-Laufzeit.
-2. Tunnel die Loopback-Brücke (oder Proxy-Bridge-Aufrufe zurück zum übergeordneten Element).
-3. Große Datenaufträge können unabhängig vom Anforderungslebenszyklus bis zum Abschluss ausgeführt werden – wobei die gehostete Code-Exec-Obergrenze von ca. 40 Sekunden überschritten wird, die den lokalen untergeordneten Prozessadapter begrenzt.
+1. `SandboxAdapter.run` gegen eine Out-of-Process-Laufzeit implementieren.
+2. Die Loopback-Brücke tunneln oder Bridge-Aufrufe zum übergeordneten Prozess zurückleiten.
+3. Remote- oder Container-Isolation unabhängig vom ausgelieferten dauerhaften Warteschlangenlebenszyklus bereitstellen.
-Registrieren Sie es unter einem neuen `AGENT_NATIVE_SANDBOX`-Wert (z. B. `remote`) und/oder über `registerSandboxAdapter()`. Die Agentenschleife und `run-code.ts` ändern sich nie.
+Registrieren Sie ihn programmgesteuert über `registerSandboxAdapter()`. Die Agentenschleife und `run-code.ts` müssen sich nicht ändern.
 > [!TIP]
 > Der `agent-native add sandbox docker`-Blueprint liefert ein vollständiges, eigenständiges Rezept für die Implementierung eines Docker-Adapters gegen diese Naht. Siehe [Blueprint Installer](/docs/blueprint-installer).

package/docs/content/locales/de-DE/security.mdx CHANGED Viewed

@@ -417,3 +417,11 @@ AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK=1
 ```
 Für geheime Schreibvorgänge im Arbeitsbereichsbereich ist unabhängig von diesem Flag weiterhin die Rolle „Organisationsbesitzer/-administrator“ erforderlich.
+## Nächste Schritte
+- [**Authentication**](/docs/authentication) — Auth-Modi, Cookie-Realms und Sitzungsdetails, auf denen diese Seite aufbaut
+- [**Multi-Tenancy**](/docs/multi-tenancy) — das Org-Mitgliedschaftsmodell hinter dem `org_id`-Scoping
+- [**Sharing**](/docs/sharing) — das `ownableColumns()`- und Access-Guard-Muster, angewendet auf teilbare Ressourcen
+- [**Messaging**](/docs/messaging#env-vars) — die Webhook-Signaturgeheimnisse pro Integration, auf die in der obigen Checkliste verwiesen wird
+- [**Deployment**](/docs/deployment) — die Produktionsumgebungsvariablen, deren Vorhandensein diese Checkliste voraussetzt

package/docs/content/locales/es-ES/audit-log.mdx CHANGED Viewed

@@ -73,10 +73,11 @@ Todo en `audit` es opcional. La adición mínima útil es `target: () => ({ type
 ## Leyendo el rastro {#reading}
-Hay dos lecturas actions disponibles para el agente **y** la interfaz de cada aplicación, con alcance en SQL para la persona que llama; nunca devuelven las filas de otro inquilino:
+Hay tres lecturas actions disponibles para el agente **y** la interfaz de cada aplicación, con alcance en SQL para la persona que llama; nunca devuelven las filas de otro inquilino:
 - **`list-audit-events`** — filtrar por `targetType` / `targetId`, `actorKind` (`agent` | `human` | `system`), `status`, `threadId` / `turnId`, `action`, `sinceMs` y `limit`.
 - **`get-audit-event`**: un evento por ID, incluida su carga útil de entrada redactada.
+- **`export-audit-events`** — exporta el rastro en bloque como CSV o NDJSON en lugar de paginar manualmente `list-audit-events`, para extracciones de cumplimiento sin conexión. Toma los mismos filtros que `list-audit-events` (sin `limit`) más `format` (`csv` | `ndjson`, por defecto `csv`) y `maxRows` (por defecto 5000, tope máximo 10000), y devuelve `{ content, rowCount, truncated, format }` — `truncated: true` significa que hubo más filas coincidentes de las que permitía `maxRows`. Es en sí misma una lectura sensible, auditada mediante `audit: { onRead: true }`.
 Cree una fuente de actividad o una línea "quién cambió esto" llamando a `list-audit-events` desde UI con `useActionQuery`; nunca escriba a mano una búsqueda en la tabla de auditoría:

package/docs/content/locales/es-ES/automations.mdx CHANGED Viewed

@@ -114,13 +114,13 @@ La tercera ruta (escribir el archivo `jobs/<name>.md` a mano mediante `resourceP
 Las automatizaciones comparten todos los campos del [recurring-jobs frontmatter table](/docs/recurring-jobs#frontmatter). Estos campos adicionales controlan los desencadenadores de eventos, las condiciones y el modo de ejecución:
-| Campo         | Tipo                             | Predeterminado | Descripción                                                                                                                                                                                                  |
-| ------------- | -------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `triggerType` | `"schedule"` \| `"event"`        | `"schedule"`   | Cómo se activa la automatización                                                                                                                                                                             |
-| `event`       | cadena                           | _(opcional)_   | Nombre del evento al que suscribirse (solo activadores de eventos)                                                                                                                                           |
-| `condition`   | cadena                           | _(opcional)_   | Condición del lenguaje natural evaluada antes del envío                                                                                                                                                      |
-| `mode`        | `"agentic"` \| `"deterministic"` | `"agentic"`    | Bucle de agente completo. (`"deterministic"` está reservado pero aún no se ha implementado; las automatizaciones que lo configuran se omiten. Utilice `"agentic"` para todas las automatizaciones actuales). |
-| `domain`      | cadena                           | _(opcional)_   | Etiqueta de agrupación (correo, calendario, clips, etc.)                                                                                                                                                     |
+| Campo         | Tipo                      | Predeterminado | Descripción                                                                                                                                                                |
+| ------------- | ------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `triggerType` | `"schedule"` \| `"event"` | `"schedule"`   | Cómo se activa la automatización                                                                                                                                           |
+| `event`       | cadena                    | _(opcional)_   | Nombre del evento al que suscribirse (solo activadores de eventos)                                                                                                         |
+| `condition`   | cadena                    | _(opcional)_   | Condición del lenguaje natural evaluada antes del envío                                                                                                                    |
+| `mode`        | `"agentic"`               | `"agentic"`    | Bucle de agente completo (el único modo compatible). `"deterministic"` fue eliminado: nunca se implementó, y las automatizaciones que lo configuraban nunca se ejecutaban. |
+| `domain`      | cadena                    | _(opcional)_   | Etiqueta de agrupación (correo, calendario, clips, etc.)                                                                                                                   |
 Para un desencadenador de evento, `schedule` es `""` (vacío); para un desencadenador de programación, lleva la expresión cron. El despachador también escribe los mismos campos administrados `lastRun` / `lastStatus` / `lastError` que escribe el programador, además de un estado `"skipped"` cuando una condición se evalúa como falsa.

package/docs/content/locales/es-ES/getting-started.mdx CHANGED Viewed

@@ -163,7 +163,13 @@ Añade una route `/response-insights` con `useActionQuery("list-response-insight
   />
 </WireframeBlock>
-Extiende `view-screen` y `navigate` para que el agent conozca la route actual y pueda abrir `/response-insights`. Los resultados también pueden incluir `href: "/response-insights"` para mostrar un botón "Abrir insights de respuestas".
+## 6. Deja que el agent navegue {#agent-navigation}
+La Chat template incluye las actions `view-screen` y `navigate`. Amplíalas a medida que tu app crece:
+- `view-screen` debería leer el application state y devolver la route actual, el insight seleccionado, los filtros activos y cualquier contexto de página compacto que el agent necesite.
+- `navigate` debería escribir una route same-origin como `/response-insights` cuando el agent decida que el usuario debe inspeccionar el resultado visualmente.
+- Los resultados de una action pueden incluir enlaces como `href: "/response-insights"` para que el chat ofrezca un botón explícito "Abrir insights de respuestas".
 Cuando el chat de página completa abra una página de app, usa `AgentChatSurface`, `AgentSidebar`, `useAgentChatHomeHandoff`, `useAgentChatHomeHandoffLinks` y `chatViewTransition` desde [Agent Surfaces](/docs/agent-surfaces#rich-chat) para deslizar el chat al panel lateral sin perder el thread.