@lunora/config 1.0.0-alpha.65 → 1.0.0-alpha.67

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { ContainerIR, WorkflowIR, QueueIR, WranglerVariableIR } from '@lunora/codegen';
-export type { ContainerIR, WorkflowIR } from '@lunora/codegen';
+import { AgentIR, ContainerIR, WorkflowIR, QueueIR, WranglerVariableIR } from '@lunora/codegen';
+export type { AgentIR, ContainerIR, WorkflowIR } from '@lunora/codegen';
 import { Writable } from 'node:stream';
 import 'ts-morph';
 export { type A as AdditivePolicyEdit, type D as DestructivePolicyEdit, type P as PolicyEdit, type a as PolicyScaffoldFailureReason, type b as ScaffoldFileResult, type S as ScaffoldPolicyEdit, type c as WireResult, type W as WireRlsEdit, d as classifyPolicyEdit, s as scaffoldPolicyFile, w as wireRlsIntoProcedure } from "./packem_shared/policy-scaffold.d-DCmwn7zQ.mjs";
@@ -20,6 +20,19 @@ declare const AGENT_MODE_ENV = "LUNORA_AGENT_MODE";
 * both directions. Pure — pass a custom `env` in tests.
 */
 declare const detectAiAgent: (env?: EnvLike) => AgentDetection | undefined;
+interface DiscoverAgentInfoResult {
+  /** Discovered agent definitions; `[]` when none are declared or parsing failed. */
+  agents: ReadonlyArray<AgentIR>;
+  /** Parse error message, when `lunora/agents.ts` exists but could not be analyzed. */
+  error?: string;
+}
+/**
+* Discover the project's `defineAgent` declarations. Returns `{ agents: [] }`
+* when the project has no `lunora/agents.ts` (not an error), or
+* `{ agents: [], error }` when the file exists but could not be parsed — callers
+* decide whether that is a warning (validator) or ignorable (inference).
+*/
+declare const discoverAgentInfo: (projectRoot: string, schemaDirectory: string) => DiscoverAgentInfoResult;
 /**
 * Project-relative directory the Lunora agent skills ("rules") install into.
 * This is the portable [Agent Skills](https://tanstack.com/intent/latest/docs/registry)
@@ -359,6 +372,17 @@ interface InferredWorkflow extends WorkflowIR {
   exported: boolean;
 }
 /**
+* A `defineAgent` declaration plus whether its generated agent
+* `WorkflowEntrypoint` class (e.g. `SupportAgentWorkflow`) is exported by the
+* worker entry. An agent compiles onto a Cloudflare Workflow, so — exactly like
+* {@link InferredWorkflow} — only exported agents are safe to provision
+* (wrangler rejects a `workflows[].class_name` the worker doesn't export), and
+* an agent is NOT a Durable Object (no `durable_objects` binding or migration).
+*/
+interface InferredAgent extends AgentIR {
+  exported: boolean;
+}
+/**
 * A queue declared in `lunora/queues.ts`. Unlike workflows, a queue needs no
 * worker-entry class export (its `queue()` handler rides `createWorker`), so
 * there is no `exported` flag — every declared queue is reconcilable into the
@@ -366,6 +390,8 @@ interface InferredWorkflow extends WorkflowIR {
 */
 type InferredQueue = QueueIR;
 interface InferredBindings {
+  /** Agents declared in `lunora/agents.ts` (exported or not — see {@link InferredAgent.exported}); reconciled into `workflows[]`. */
+  agents: InferredAgent[];
   /** Containers declared in `lunora/containers.ts` (exported or not — see {@link InferredContainer.exported}). */
   containers: InferredContainer[];
   /** Durable Objects the worker entry exports → safe to bind. */
@@ -689,12 +715,12 @@ declare const promptMultiSelect: <T extends string>(message: string, options: Re
 interface ExportGap {
   /** Generated class wrangler needs exported, e.g. `OrderPipelineWorkflow`. */
   className: string;
-  /** The `lunora/{containers,workflows}.ts` export name, e.g. `orderPipeline`. */
+  /** The `lunora/{agents,containers,workflows}.ts` export name, e.g. `orderPipeline`. */
   exportName: string;
   /** Which declaration is unexported. */
-  kind: "container" | "workflow";
+  kind: "agent" | "container" | "workflow";
   /** The `_generated/{module}` to re-export from, e.g. `workflows`. */
-  module: "containers" | "workflows";
+  module: "agents" | "containers" | "workflows";
 }
 interface ReconcileBindingsResult {
   /** Short labels for each binding written (e.g. `"SCHEDULER/SchedulerDO"`). */
@@ -1494,4 +1520,4 @@ interface WranglerProjectValidationResult {
 * `{ problems, wranglerPath }` shape plus the structured `report`.
 */
 declare const validateWranglerProject: (options: WranglerProjectValidationOptions) => WranglerProjectValidationResult;
-export { ACCENT, AGENT_MODE_ENV, AGENT_RULES_DIR, AGENT_RULES_HINT, AGENT_RULES_HINT_ENV, type AddIndexEdit, type AddOptionalColumnEdit, type AddTableEdit, type AdditiveEdit, type AgentDetection, type AgentRulesStatus, type ApplyEditResult, type ApplyFailureReason, type AugmentPlan, BADGES, BADGE_COLUMN_WIDTH, type BadgeName, type BadgeSpec, type ClaimDevServerStateResult, type ContainerLogLevel, type ContainerLogLine, type ContainerLogSource, type ContainerLogStreamHandle, type ContainerLogStreamOptions, DEV_DAEMON_ENV, DEV_HANDOFF_ENV, DEV_LOG_FILE, DEV_LOG_FILE_ENV, DEV_STATE_DIR, DEV_STATE_FILE, DEV_VARS_EXAMPLE_FILE, DEV_VARS_FILE, DEV_VARS_KEY_PATTERN, type DestructiveEdit, type DetectedFramework, type DevSecretsFillPlan, type DevServerMode, type DevServerState, type DiscoverContainerInfoResult, type DiscoverSchemaInfoResult, type DiscoverWorkflowInfoResult, type DockerLike, type EnsureDevVariablesDeps, type EnsureDevVariablesResult, type EnsureDevVariablesStatus, type ExportGap, type FillDevSecretsResult, type FrameworkClass, type FrameworkDetection, type InferOptions, type InferredBindings, type InferredContainer, type InferredWorkflow, LINKED_PROJECT_DIR, LINKED_PROJECT_FILE, LUNA_ART, LUNA_BUNNY, LUNA_NAME, LUNA_SIGNOFF, LUNORA_CONFIG_FILE, LUNORA_EVENT_SOURCE, LUNORA_SKILL_NAMES, type LevelBadgeName, type LinkedProject, type LunoraFormattedLine, type LunoraLineLevel, type LunoraProjectConfig, LunoraReporter, type MaterializeOptions, type MaterializeResult, type MultiSelectOption, PACKAGE_SECRETS_REGISTRY, type ParseSchemaResult, REMOTE_ELIGIBLE_KEYS, REQUIRED_COMPATIBILITY_DATE, REQUIRED_FLAG, ROOT_SKILL_NAME, type ReadWranglerResult, type ReconcileBindingsResult, type ReconcileCompatibilityDateResult, type RemoteBindingPlan, type RemoteEnableInputs, type RemotePreference, type RemoteWranglerShape, STEP_BADGE_NAMES, type ScaffoldPlan, type SchemaColumn, type SchemaEdit, type SchemaIndex, type SchemaInfo, type SchemaTable, type SecretEntry, type SelectOption, type StepBadgeName, type TailConsumer, WRANGLER_FILES, type WranglerConfig, type WranglerContainerEntry, type WranglerProjectValidationOptions, type WranglerProjectValidationResult, type WranglerValidationReport, type WranglerWorkflowEntry, applyAdditiveEdit, badgeLead, badgeWidth, buildPackageSecretsBlock, claimAgentRulesHint, claimDevServerState, classifyEdit, clearDevServerState, collectWranglerSecretVariables, createConfirm, detectAgentRules, detectAiAgent, detectFramework, discoverContainerInfo, discoverSchemaInfo, discoverWorkflowInfo, ensureDevVariables, ensureDevVariablesExample as ensureDevVarsExample, fillDevSecrets, findWranglerFile, formatLunoraEvent, generateSecretValue, inferLunoraBindings, injectRemoteFlags, interpretRemote, isInteractive, isMintableSecretKey, isPlaceholderValue, isProcessAlive, isRecordedProcessCurrent, isRemoteEnvEnabled, materializeRemoteWranglerConfig, packageNamesFromBindings, padBadge, paintAnswer, paintBadge, parseDevVariableEntries, parseSchema, planDevSecretsFill, planDevVariablesAugment, planDevVariablesScaffold, planRemoteBindings, promptMultiSelect, promptSelect, promptYesNo, readDevServerState, readLinkedProject, readLiveDevServerState, readProjectDependencyNames, readProjectRemotePreference, readWranglerJsonc, reconcileWranglerBindings, reconcileWranglerCompatibilityDate, requiredSecrets, resolveRemoteEnabled, scanWranglerVariablesForSecrets, secretsForPackages, streamContainerLogs, updateDevServerState, validateWrangler, validateWranglerConfig, validateWranglerProject, withTailConsumer, writeDevServerState, writeLinkedProject };
+export { ACCENT, AGENT_MODE_ENV, AGENT_RULES_DIR, AGENT_RULES_HINT, AGENT_RULES_HINT_ENV, type AddIndexEdit, type AddOptionalColumnEdit, type AddTableEdit, type AdditiveEdit, type AgentDetection, type AgentRulesStatus, type ApplyEditResult, type ApplyFailureReason, type AugmentPlan, BADGES, BADGE_COLUMN_WIDTH, type BadgeName, type BadgeSpec, type ClaimDevServerStateResult, type ContainerLogLevel, type ContainerLogLine, type ContainerLogSource, type ContainerLogStreamHandle, type ContainerLogStreamOptions, DEV_DAEMON_ENV, DEV_HANDOFF_ENV, DEV_LOG_FILE, DEV_LOG_FILE_ENV, DEV_STATE_DIR, DEV_STATE_FILE, DEV_VARS_EXAMPLE_FILE, DEV_VARS_FILE, DEV_VARS_KEY_PATTERN, type DestructiveEdit, type DetectedFramework, type DevSecretsFillPlan, type DevServerMode, type DevServerState, type DiscoverAgentInfoResult, type DiscoverContainerInfoResult, type DiscoverSchemaInfoResult, type DiscoverWorkflowInfoResult, type DockerLike, type EnsureDevVariablesDeps, type EnsureDevVariablesResult, type EnsureDevVariablesStatus, type ExportGap, type FillDevSecretsResult, type FrameworkClass, type FrameworkDetection, type InferOptions, type InferredAgent, type InferredBindings, type InferredContainer, type InferredWorkflow, LINKED_PROJECT_DIR, LINKED_PROJECT_FILE, LUNA_ART, LUNA_BUNNY, LUNA_NAME, LUNA_SIGNOFF, LUNORA_CONFIG_FILE, LUNORA_EVENT_SOURCE, LUNORA_SKILL_NAMES, type LevelBadgeName, type LinkedProject, type LunoraFormattedLine, type LunoraLineLevel, type LunoraProjectConfig, LunoraReporter, type MaterializeOptions, type MaterializeResult, type MultiSelectOption, PACKAGE_SECRETS_REGISTRY, type ParseSchemaResult, REMOTE_ELIGIBLE_KEYS, REQUIRED_COMPATIBILITY_DATE, REQUIRED_FLAG, ROOT_SKILL_NAME, type ReadWranglerResult, type ReconcileBindingsResult, type ReconcileCompatibilityDateResult, type RemoteBindingPlan, type RemoteEnableInputs, type RemotePreference, type RemoteWranglerShape, STEP_BADGE_NAMES, type ScaffoldPlan, type SchemaColumn, type SchemaEdit, type SchemaIndex, type SchemaInfo, type SchemaTable, type SecretEntry, type SelectOption, type StepBadgeName, type TailConsumer, WRANGLER_FILES, type WranglerConfig, type WranglerContainerEntry, type WranglerProjectValidationOptions, type WranglerProjectValidationResult, type WranglerValidationReport, type WranglerWorkflowEntry, applyAdditiveEdit, badgeLead, badgeWidth, buildPackageSecretsBlock, claimAgentRulesHint, claimDevServerState, classifyEdit, clearDevServerState, collectWranglerSecretVariables, createConfirm, detectAgentRules, detectAiAgent, detectFramework, discoverAgentInfo, discoverContainerInfo, discoverSchemaInfo, discoverWorkflowInfo, ensureDevVariables, ensureDevVariablesExample as ensureDevVarsExample, fillDevSecrets, findWranglerFile, formatLunoraEvent, generateSecretValue, inferLunoraBindings, injectRemoteFlags, interpretRemote, isInteractive, isMintableSecretKey, isPlaceholderValue, isProcessAlive, isRecordedProcessCurrent, isRemoteEnvEnabled, materializeRemoteWranglerConfig, packageNamesFromBindings, padBadge, paintAnswer, paintBadge, parseDevVariableEntries, parseSchema, planDevSecretsFill, planDevVariablesAugment, planDevVariablesScaffold, planRemoteBindings, promptMultiSelect, promptSelect, promptYesNo, readDevServerState, readLinkedProject, readLiveDevServerState, readProjectDependencyNames, readProjectRemotePreference, readWranglerJsonc, reconcileWranglerBindings, reconcileWranglerCompatibilityDate, requiredSecrets, resolveRemoteEnabled, scanWranglerVariablesForSecrets, secretsForPackages, streamContainerLogs, updateDevServerState, validateWrangler, validateWranglerConfig, validateWranglerProject, withTailConsumer, writeDevServerState, writeLinkedProject };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { ContainerIR, WorkflowIR, QueueIR, WranglerVariableIR } from '@lunora/codegen';
-export type { ContainerIR, WorkflowIR } from '@lunora/codegen';
+import { AgentIR, ContainerIR, WorkflowIR, QueueIR, WranglerVariableIR } from '@lunora/codegen';
+export type { AgentIR, ContainerIR, WorkflowIR } from '@lunora/codegen';
 import { Writable } from 'node:stream';
 import 'ts-morph';
 export { type A as AdditivePolicyEdit, type D as DestructivePolicyEdit, type P as PolicyEdit, type a as PolicyScaffoldFailureReason, type b as ScaffoldFileResult, type S as ScaffoldPolicyEdit, type c as WireResult, type W as WireRlsEdit, d as classifyPolicyEdit, s as scaffoldPolicyFile, w as wireRlsIntoProcedure } from "./packem_shared/policy-scaffold.d-DCmwn7zQ.js";
@@ -20,6 +20,19 @@ declare const AGENT_MODE_ENV = "LUNORA_AGENT_MODE";
 * both directions. Pure — pass a custom `env` in tests.
 */
 declare const detectAiAgent: (env?: EnvLike) => AgentDetection | undefined;
+interface DiscoverAgentInfoResult {
+  /** Discovered agent definitions; `[]` when none are declared or parsing failed. */
+  agents: ReadonlyArray<AgentIR>;
+  /** Parse error message, when `lunora/agents.ts` exists but could not be analyzed. */
+  error?: string;
+}
+/**
+* Discover the project's `defineAgent` declarations. Returns `{ agents: [] }`
+* when the project has no `lunora/agents.ts` (not an error), or
+* `{ agents: [], error }` when the file exists but could not be parsed — callers
+* decide whether that is a warning (validator) or ignorable (inference).
+*/
+declare const discoverAgentInfo: (projectRoot: string, schemaDirectory: string) => DiscoverAgentInfoResult;
 /**
 * Project-relative directory the Lunora agent skills ("rules") install into.
 * This is the portable [Agent Skills](https://tanstack.com/intent/latest/docs/registry)
@@ -359,6 +372,17 @@ interface InferredWorkflow extends WorkflowIR {
   exported: boolean;
 }
 /**
+* A `defineAgent` declaration plus whether its generated agent
+* `WorkflowEntrypoint` class (e.g. `SupportAgentWorkflow`) is exported by the
+* worker entry. An agent compiles onto a Cloudflare Workflow, so — exactly like
+* {@link InferredWorkflow} — only exported agents are safe to provision
+* (wrangler rejects a `workflows[].class_name` the worker doesn't export), and
+* an agent is NOT a Durable Object (no `durable_objects` binding or migration).
+*/
+interface InferredAgent extends AgentIR {
+  exported: boolean;
+}
+/**
 * A queue declared in `lunora/queues.ts`. Unlike workflows, a queue needs no
 * worker-entry class export (its `queue()` handler rides `createWorker`), so
 * there is no `exported` flag — every declared queue is reconcilable into the
@@ -366,6 +390,8 @@ interface InferredWorkflow extends WorkflowIR {
 */
 type InferredQueue = QueueIR;
 interface InferredBindings {
+  /** Agents declared in `lunora/agents.ts` (exported or not — see {@link InferredAgent.exported}); reconciled into `workflows[]`. */
+  agents: InferredAgent[];
   /** Containers declared in `lunora/containers.ts` (exported or not — see {@link InferredContainer.exported}). */
   containers: InferredContainer[];
   /** Durable Objects the worker entry exports → safe to bind. */
@@ -689,12 +715,12 @@ declare const promptMultiSelect: <T extends string>(message: string, options: Re
 interface ExportGap {
   /** Generated class wrangler needs exported, e.g. `OrderPipelineWorkflow`. */
   className: string;
-  /** The `lunora/{containers,workflows}.ts` export name, e.g. `orderPipeline`. */
+  /** The `lunora/{agents,containers,workflows}.ts` export name, e.g. `orderPipeline`. */
   exportName: string;
   /** Which declaration is unexported. */
-  kind: "container" | "workflow";
+  kind: "agent" | "container" | "workflow";
   /** The `_generated/{module}` to re-export from, e.g. `workflows`. */
-  module: "containers" | "workflows";
+  module: "agents" | "containers" | "workflows";
 }
 interface ReconcileBindingsResult {
   /** Short labels for each binding written (e.g. `"SCHEDULER/SchedulerDO"`). */
@@ -1494,4 +1520,4 @@ interface WranglerProjectValidationResult {
 * `{ problems, wranglerPath }` shape plus the structured `report`.
 */
 declare const validateWranglerProject: (options: WranglerProjectValidationOptions) => WranglerProjectValidationResult;
-export { ACCENT, AGENT_MODE_ENV, AGENT_RULES_DIR, AGENT_RULES_HINT, AGENT_RULES_HINT_ENV, type AddIndexEdit, type AddOptionalColumnEdit, type AddTableEdit, type AdditiveEdit, type AgentDetection, type AgentRulesStatus, type ApplyEditResult, type ApplyFailureReason, type AugmentPlan, BADGES, BADGE_COLUMN_WIDTH, type BadgeName, type BadgeSpec, type ClaimDevServerStateResult, type ContainerLogLevel, type ContainerLogLine, type ContainerLogSource, type ContainerLogStreamHandle, type ContainerLogStreamOptions, DEV_DAEMON_ENV, DEV_HANDOFF_ENV, DEV_LOG_FILE, DEV_LOG_FILE_ENV, DEV_STATE_DIR, DEV_STATE_FILE, DEV_VARS_EXAMPLE_FILE, DEV_VARS_FILE, DEV_VARS_KEY_PATTERN, type DestructiveEdit, type DetectedFramework, type DevSecretsFillPlan, type DevServerMode, type DevServerState, type DiscoverContainerInfoResult, type DiscoverSchemaInfoResult, type DiscoverWorkflowInfoResult, type DockerLike, type EnsureDevVariablesDeps, type EnsureDevVariablesResult, type EnsureDevVariablesStatus, type ExportGap, type FillDevSecretsResult, type FrameworkClass, type FrameworkDetection, type InferOptions, type InferredBindings, type InferredContainer, type InferredWorkflow, LINKED_PROJECT_DIR, LINKED_PROJECT_FILE, LUNA_ART, LUNA_BUNNY, LUNA_NAME, LUNA_SIGNOFF, LUNORA_CONFIG_FILE, LUNORA_EVENT_SOURCE, LUNORA_SKILL_NAMES, type LevelBadgeName, type LinkedProject, type LunoraFormattedLine, type LunoraLineLevel, type LunoraProjectConfig, LunoraReporter, type MaterializeOptions, type MaterializeResult, type MultiSelectOption, PACKAGE_SECRETS_REGISTRY, type ParseSchemaResult, REMOTE_ELIGIBLE_KEYS, REQUIRED_COMPATIBILITY_DATE, REQUIRED_FLAG, ROOT_SKILL_NAME, type ReadWranglerResult, type ReconcileBindingsResult, type ReconcileCompatibilityDateResult, type RemoteBindingPlan, type RemoteEnableInputs, type RemotePreference, type RemoteWranglerShape, STEP_BADGE_NAMES, type ScaffoldPlan, type SchemaColumn, type SchemaEdit, type SchemaIndex, type SchemaInfo, type SchemaTable, type SecretEntry, type SelectOption, type StepBadgeName, type TailConsumer, WRANGLER_FILES, type WranglerConfig, type WranglerContainerEntry, type WranglerProjectValidationOptions, type WranglerProjectValidationResult, type WranglerValidationReport, type WranglerWorkflowEntry, applyAdditiveEdit, badgeLead, badgeWidth, buildPackageSecretsBlock, claimAgentRulesHint, claimDevServerState, classifyEdit, clearDevServerState, collectWranglerSecretVariables, createConfirm, detectAgentRules, detectAiAgent, detectFramework, discoverContainerInfo, discoverSchemaInfo, discoverWorkflowInfo, ensureDevVariables, ensureDevVariablesExample as ensureDevVarsExample, fillDevSecrets, findWranglerFile, formatLunoraEvent, generateSecretValue, inferLunoraBindings, injectRemoteFlags, interpretRemote, isInteractive, isMintableSecretKey, isPlaceholderValue, isProcessAlive, isRecordedProcessCurrent, isRemoteEnvEnabled, materializeRemoteWranglerConfig, packageNamesFromBindings, padBadge, paintAnswer, paintBadge, parseDevVariableEntries, parseSchema, planDevSecretsFill, planDevVariablesAugment, planDevVariablesScaffold, planRemoteBindings, promptMultiSelect, promptSelect, promptYesNo, readDevServerState, readLinkedProject, readLiveDevServerState, readProjectDependencyNames, readProjectRemotePreference, readWranglerJsonc, reconcileWranglerBindings, reconcileWranglerCompatibilityDate, requiredSecrets, resolveRemoteEnabled, scanWranglerVariablesForSecrets, secretsForPackages, streamContainerLogs, updateDevServerState, validateWrangler, validateWranglerConfig, validateWranglerProject, withTailConsumer, writeDevServerState, writeLinkedProject };
+export { ACCENT, AGENT_MODE_ENV, AGENT_RULES_DIR, AGENT_RULES_HINT, AGENT_RULES_HINT_ENV, type AddIndexEdit, type AddOptionalColumnEdit, type AddTableEdit, type AdditiveEdit, type AgentDetection, type AgentRulesStatus, type ApplyEditResult, type ApplyFailureReason, type AugmentPlan, BADGES, BADGE_COLUMN_WIDTH, type BadgeName, type BadgeSpec, type ClaimDevServerStateResult, type ContainerLogLevel, type ContainerLogLine, type ContainerLogSource, type ContainerLogStreamHandle, type ContainerLogStreamOptions, DEV_DAEMON_ENV, DEV_HANDOFF_ENV, DEV_LOG_FILE, DEV_LOG_FILE_ENV, DEV_STATE_DIR, DEV_STATE_FILE, DEV_VARS_EXAMPLE_FILE, DEV_VARS_FILE, DEV_VARS_KEY_PATTERN, type DestructiveEdit, type DetectedFramework, type DevSecretsFillPlan, type DevServerMode, type DevServerState, type DiscoverAgentInfoResult, type DiscoverContainerInfoResult, type DiscoverSchemaInfoResult, type DiscoverWorkflowInfoResult, type DockerLike, type EnsureDevVariablesDeps, type EnsureDevVariablesResult, type EnsureDevVariablesStatus, type ExportGap, type FillDevSecretsResult, type FrameworkClass, type FrameworkDetection, type InferOptions, type InferredAgent, type InferredBindings, type InferredContainer, type InferredWorkflow, LINKED_PROJECT_DIR, LINKED_PROJECT_FILE, LUNA_ART, LUNA_BUNNY, LUNA_NAME, LUNA_SIGNOFF, LUNORA_CONFIG_FILE, LUNORA_EVENT_SOURCE, LUNORA_SKILL_NAMES, type LevelBadgeName, type LinkedProject, type LunoraFormattedLine, type LunoraLineLevel, type LunoraProjectConfig, LunoraReporter, type MaterializeOptions, type MaterializeResult, type MultiSelectOption, PACKAGE_SECRETS_REGISTRY, type ParseSchemaResult, REMOTE_ELIGIBLE_KEYS, REQUIRED_COMPATIBILITY_DATE, REQUIRED_FLAG, ROOT_SKILL_NAME, type ReadWranglerResult, type ReconcileBindingsResult, type ReconcileCompatibilityDateResult, type RemoteBindingPlan, type RemoteEnableInputs, type RemotePreference, type RemoteWranglerShape, STEP_BADGE_NAMES, type ScaffoldPlan, type SchemaColumn, type SchemaEdit, type SchemaIndex, type SchemaInfo, type SchemaTable, type SecretEntry, type SelectOption, type StepBadgeName, type TailConsumer, WRANGLER_FILES, type WranglerConfig, type WranglerContainerEntry, type WranglerProjectValidationOptions, type WranglerProjectValidationResult, type WranglerValidationReport, type WranglerWorkflowEntry, applyAdditiveEdit, badgeLead, badgeWidth, buildPackageSecretsBlock, claimAgentRulesHint, claimDevServerState, classifyEdit, clearDevServerState, collectWranglerSecretVariables, createConfirm, detectAgentRules, detectAiAgent, detectFramework, discoverAgentInfo, discoverContainerInfo, discoverSchemaInfo, discoverWorkflowInfo, ensureDevVariables, ensureDevVariablesExample as ensureDevVarsExample, fillDevSecrets, findWranglerFile, formatLunoraEvent, generateSecretValue, inferLunoraBindings, injectRemoteFlags, interpretRemote, isInteractive, isMintableSecretKey, isPlaceholderValue, isProcessAlive, isRecordedProcessCurrent, isRemoteEnvEnabled, materializeRemoteWranglerConfig, packageNamesFromBindings, padBadge, paintAnswer, paintBadge, parseDevVariableEntries, parseSchema, planDevSecretsFill, planDevVariablesAugment, planDevVariablesScaffold, planRemoteBindings, promptMultiSelect, promptSelect, promptYesNo, readDevServerState, readLinkedProject, readLiveDevServerState, readProjectDependencyNames, readProjectRemotePreference, readWranglerJsonc, reconcileWranglerBindings, reconcileWranglerCompatibilityDate, requiredSecrets, resolveRemoteEnabled, scanWranglerVariablesForSecrets, secretsForPackages, streamContainerLogs, updateDevServerState, validateWrangler, validateWranglerConfig, validateWranglerProject, withTailConsumer, writeDevServerState, writeLinkedProject };

package/dist/index.mjs

@@ -1,18 +1,19 @@
 export { AGENT_MODE_ENV, detectAiAgent } from './packem_shared/AGENT_MODE_ENV-B5R7jpY7.mjs';
+export { discoverAgentInfo } from './packem_shared/discoverAgentInfo-eXA3hF4v.mjs';
 export { AGENT_RULES_DIR, AGENT_RULES_HINT, AGENT_RULES_HINT_ENV, LUNORA_SKILL_NAMES, ROOT_SKILL_NAME, claimAgentRulesHint, detectAgentRules } from './packem_shared/AGENT_RULES_DIR-lcgC08aE.mjs';
 export { discoverContainerInfo } from './packem_shared/discoverContainerInfo-BXFs6Wav.mjs';
 export { streamContainerLogs } from './packem_shared/streamContainerLogs-BZ4cOZwH.mjs';
 export { detectFramework, readProjectDependencyNames } from './packem_shared/detectFramework-U08038Yp.mjs';
 export { DEV_DAEMON_ENV, DEV_HANDOFF_ENV, DEV_LOG_FILE, DEV_LOG_FILE_ENV, DEV_STATE_DIR, DEV_STATE_FILE, claimDevServerState, clearDevServerState, isProcessAlive, isRecordedProcessCurrent, readDevServerState, readLiveDevServerState, updateDevServerState, writeDevServerState } from './packem_shared/DEV_DAEMON_ENV-FIEtW7Fz.mjs';
 export { DEV_VARS_EXAMPLE_FILE, DEV_VARS_FILE, DEV_VARS_KEY_PATTERN, parseDevVariableEntries } from './packem_shared/DEV_VARS_EXAMPLE_FILE-dJPNTEnK.mjs';
-export { inferLunoraBindings, packageNamesFromBindings } from './packem_shared/inferLunoraBindings-BadOK1UZ.mjs';
+export { inferLunoraBindings, packageNamesFromBindings } from './packem_shared/inferLunoraBindings-CPmUh1LN.mjs';
 export { LINKED_PROJECT_DIR, LINKED_PROJECT_FILE, readLinkedProject, writeLinkedProject } from './packem_shared/LINKED_PROJECT_DIR-CXwXzV_C.mjs';
 export { LUNORA_EVENT_SOURCE, formatLunoraEvent } from './packem_shared/LUNORA_EVENT_SOURCE-D2fDeGB6.mjs';
 export { default as LunoraReporter } from './packem_shared/LunoraReporter-Ci-bDCK9.mjs';
 export { PACKAGE_SECRETS_REGISTRY, secretsForPackages } from './packem_shared/PACKAGE_SECRETS_REGISTRY-BeRSvrl5.mjs';
 export { LUNORA_CONFIG_FILE, interpretRemote, readProjectRemotePreference } from './packem_shared/LUNORA_CONFIG_FILE-CtcIcB5-.mjs';
 export { createConfirm, isInteractive, promptMultiSelect, promptSelect, promptYesNo } from './packem_shared/createConfirm-fvpdgJ9s.mjs';
-export { reconcileWranglerBindings } from './packem_shared/reconcileWranglerBindings-BhQN61qp.mjs';
+export { reconcileWranglerBindings } from './packem_shared/reconcileWranglerBindings-2Cww5VLa.mjs';
 export { reconcileWranglerCompatibilityDate } from './packem_shared/reconcileWranglerCompatibilityDate-D5Bqjk4P.mjs';
 export { REMOTE_ELIGIBLE_KEYS, injectRemoteFlags, isRemoteEnvEnabled, materializeRemoteWranglerConfig, planRemoteBindings, resolveRemoteEnabled } from './packem_shared/REMOTE_ELIGIBLE_KEYS-C-F_Flgy.mjs';
 export { buildPackageSecretsBlock, ensureDevVariables, ensureDevVarsExample, fillDevSecrets, generateSecretValue, isMintableSecretKey, isPlaceholderValue, planDevSecretsFill, planDevVariablesAugment, planDevVariablesScaffold, requiredSecrets } from './packem_shared/buildPackageSecretsBlock-B-dWb-Sa.mjs';

package/dist/packem_shared/discoverAgentInfo-eXA3hF4v.mjs

@@ -0,0 +1,19 @@
+import { existsSync } from 'node:fs';
+import { AGENTS_FILENAME, discoverAgents } from '@lunora/codegen';
+import { Project } from 'ts-morph';
+import { join } from 'node:path';
+
+const discoverAgentInfo = (projectRoot, schemaDirectory) => {
+  const agentsPath = join(projectRoot, schemaDirectory, AGENTS_FILENAME);
+  if (!existsSync(agentsPath)) {
+    return { agents: [] };
+  }
+  try {
+    const project = new Project({ skipAddingFilesFromTsConfig: true, useInMemoryFileSystem: false });
+    return { agents: discoverAgents(project, join(projectRoot, schemaDirectory)) };
+  } catch (error) {
+    return { agents: [], error: error instanceof Error ? error.message : String(error) };
+  }
+};
+
+export { discoverAgentInfo };

package/dist/packem_shared/{inferLunoraBindings-BadOK1UZ.mjs → inferLunoraBindings-CPmUh1LN.mjs}

@@ -1,5 +1,6 @@
 import { existsSync, statSync, readFileSync, readdirSync } from 'node:fs';
 import { init, parse } from 'es-module-lexer';
+import { discoverAgentInfo } from './discoverAgentInfo-eXA3hF4v.mjs';
 import { discoverContainerInfo } from './discoverContainerInfo-BXFs6Wav.mjs';
 import { FLAGS_FILENAME, discoverFlags, QUEUES_FILENAME, discoverQueues } from '@lunora/codegen';
 import { Project } from 'ts-morph';
@@ -53,6 +54,7 @@ const ENV_DB_PATTERN = /\benv\s*\.\s*DB\b/;
 const ENV_AI_PATTERN = /\benv\s*\.\s*AI\b/;
 const CTX_PIPELINES_PATTERN = /\bctx\s*\.\s*pipelines\b/;
 const TYPE_ONLY_IMPORT_PATTERN = /^\s*import\s+type\b/;
+const SANDBOX_BROWSER_TOOL_PATTERN = /import\s+\{[^}]*\bbrowserTool\b[^}]*\}\s+from\s+["']@lunora\/agent(?:\/sandbox)?["']/;
 const CAPABILITY_SOURCES = {
   usesAi: { pattern: /\bfrom\s+["']@lunora\/ai["']/, source: "@lunora/ai" },
   usesAnalytics: { pattern: /\bfrom\s+["']@lunora\/bindings\/analytics["']/, source: "@lunora/bindings/analytics" },
@@ -133,6 +135,9 @@ const capabilitiesFromSource = (code) => {
     ...NO_CAPABILITIES,
     needsD1: ENV_DB_PATTERN.test(code),
     usesAi: ENV_AI_PATTERN.test(code),
+    // A sandbox `browserTool` import provisions BROWSER even without a direct
+    // `@lunora/browser` import (the browser op runs on the dispatcher's ctx).
+    usesBrowser: SANDBOX_BROWSER_TOOL_PATTERN.test(code),
     usesPipelines: CTX_PIPELINES_PATTERN.test(code)
   });
 };
@@ -243,6 +248,31 @@ const detectWorkflowExports = (entryPath, workflows) => {
     return { ...workflow, exported: starReexport || exportedNames.has(workflow.className) };
   });
 };
+const AGENTS_STAR_REEXPORT_PATTERN = /\bexport\s*\*\s*from\s*["'][^"']*_generated\/agents(?:\.js)?["']/;
+const detectAgentExports = (entryPath, agents) => {
+  if (agents.length === 0) {
+    return [];
+  }
+  if (entryPath === void 0) {
+    return agents.map((agent) => {
+      return { ...agent, exported: false };
+    });
+  }
+  const code = readFileSync(entryPath, "utf8");
+  const starReexport = AGENTS_STAR_REEXPORT_PATTERN.test(code);
+  let exportedNames;
+  try {
+    const [, exports] = parse(code);
+    exportedNames = new Set(exports.map((entry) => entry.n));
+  } catch {
+    exportedNames = new Set(
+      agents.map((agent) => agent.className).filter((className) => new RegExp(String.raw`\bexport\b[^\n;]*\b${className}\b`).test(code))
+    );
+  }
+  return agents.map((agent) => {
+    return { ...agent, exported: starReexport || exportedNames.has(agent.className) };
+  });
+};
 const schemaNeedsD1 = (projectRoot, schemaDirectory) => discoverSchemaInfo(projectRoot, schemaDirectory).info?.hasGlobalTable ?? false;
 const scanCapabilities = (projectRoot, scanDirectories) => {
   let merged = NO_CAPABILITIES;
@@ -259,12 +289,15 @@ const scanCapabilities = (projectRoot, scanDirectories) => {
   }
   return merged;
 };
-const describeDeclaredExports = (containers, workflows) => [
+const describeDeclaredExports = (containers, workflows, agents) => [
   ...containers.map(
     (container) => container.exported ? `${container.bindingName}/${container.className} (container "${container.exportName}" declared and exported)` : `hint: container "${container.exportName}" is declared but ${container.className} is not exported by the worker entry — add \`export * from "./lunora/_generated/containers"\``
   ),
   ...workflows.map(
     (workflow) => workflow.exported ? `${workflow.bindingName}/${workflow.className} (workflow "${workflow.exportName}" declared and exported)` : `hint: workflow "${workflow.exportName}" is declared but ${workflow.className} is not exported by the worker entry — add \`export * from "./lunora/_generated/workflows"\``
+  ),
+  ...agents.map(
+    (agent) => agent.exported ? `${agent.bindingName}/${agent.className} (agent "${agent.exportName}" declared and exported)` : `hint: agent "${agent.exportName}" is declared but ${agent.className} is not exported by the worker entry — add \`export * from "./lunora/_generated/agents"\``
   )
 ];
 const describeCapabilitySignals = (capabilities, exported) => {
@@ -309,13 +342,13 @@ const describeCapabilitySignals = (capabilities, exported) => {
   ];
   return rules.filter(([active]) => active).map(([, signal]) => signal);
 };
-const describeSignals = (durableObjects, needsD1, capabilities, containers = [], workflows = []) => {
+const describeSignals = (durableObjects, needsD1, capabilities, containers = [], workflows = [], agents = []) => {
   const exported = new Set(durableObjects.map((object) => object.className));
   const signals = durableObjects.map((object) => `${object.binding}/${object.className} (exported by worker entry)`);
   if (needsD1) {
     signals.push("DB (.global() table declared)");
   }
-  signals.push(...describeDeclaredExports(containers, workflows), ...describeCapabilitySignals(capabilities, exported));
+  signals.push(...describeDeclaredExports(containers, workflows, agents), ...describeCapabilitySignals(capabilities, exported));
   return signals;
 };
 const inferLunoraBindings = async (options) => {
@@ -328,6 +361,7 @@ const inferLunoraBindings = async (options) => {
   const needsD1 = capabilities.needsD1 || schemaNeedsD1(options.projectRoot, schemaDirectory);
   const containers = detectContainerExports(entryPath, discoverContainerInfo(options.projectRoot, schemaDirectory).containers);
   const workflows = detectWorkflowExports(entryPath, discoverWorkflowInfo(options.projectRoot, schemaDirectory).workflows);
+  const agents = detectAgentExports(entryPath, discoverAgentInfo(options.projectRoot, schemaDirectory).agents);
   const queues = [...discoverQueueInfo(options.projectRoot, schemaDirectory).queues];
   const { flags } = discoverFlagsInfo(options.projectRoot, schemaDirectory);
   const flagshipBinding = flags?.provider === "flagship" && flags.mode === "binding" ? flags.bindingName : void 0;
@@ -335,13 +369,14 @@ const inferLunoraBindings = async (options) => {
   for (const flag of CAPABILITY_FLAGS) {
     capabilityFlags[flag] = capabilities[flag];
   }
-  const signals = describeSignals(durableObjects, needsD1, capabilities, containers, workflows);
+  const signals = describeSignals(durableObjects, needsD1, capabilities, containers, workflows, agents);
   if (flagshipBinding !== void 0) {
     signals.push(
       `hint: lunora/flags.ts uses Flagship in binding mode; add a flagship binding ({ binding: "${flagshipBinding}", app_id }) — the app_id can't be auto-provisioned`
     );
   }
   return {
+    agents,
     containers,
     durableObjects,
     flagshipBinding,

package/dist/packem_shared/{reconcileWranglerBindings-BhQN61qp.mjs → reconcileWranglerBindings-2Cww5VLa.mjs}

@@ -16,6 +16,11 @@ const collectExportGaps = (inferred) => {
       gaps.push({ className: workflow.className, exportName: workflow.exportName, kind: "workflow", module: "workflows" });
     }
   }
+  for (const agent of inferred.agents) {
+    if (!agent.exported) {
+      gaps.push({ className: agent.className, exportName: agent.exportName, kind: "agent", module: "agents" });
+    }
+  }
   return gaps;
 };
 const collectHintBindingWarnings = (inferred, parsed) => {
@@ -53,6 +58,9 @@ const collectX402Warnings = (inferred) => {
   ];
   return rules.filter(([active]) => active).map(([, warning]) => warning);
 };
+const unexportedDeclarationWarnings = (kind, module, declarations) => declarations.filter((declaration) => !declaration.exported).map(
+  (declaration) => `${kind} "${declaration.exportName}" is declared but ${declaration.className} is not exported by the worker entry; add \`export * from "./lunora/_generated/${module}"\` so its binding can be provisioned.`
+);
 const collectWarnings = (inferred, parsed) => {
   const exported = new Set(inferred.durableObjects.map((object) => object.className));
   const warnings = [];
@@ -71,20 +79,11 @@ const collectWarnings = (inferred, parsed) => {
   if (inferred.usesScheduler && !exported.has("SchedulerDO")) {
     warnings.push("@lunora/scheduler is used but the worker entry exports no SchedulerDO; export it so the SCHEDULER binding can be provisioned.");
   }
-  for (const container of inferred.containers) {
-    if (!container.exported) {
-      warnings.push(
-        `container "${container.exportName}" is declared but ${container.className} is not exported by the worker entry; add \`export * from "./lunora/_generated/containers"\` so its binding can be provisioned.`
-      );
-    }
-  }
-  for (const workflow of inferred.workflows) {
-    if (!workflow.exported) {
-      warnings.push(
-        `workflow "${workflow.exportName}" is declared but ${workflow.className} is not exported by the worker entry; add \`export * from "./lunora/_generated/workflows"\` so its binding can be provisioned.`
-      );
-    }
-  }
+  warnings.push(
+    ...unexportedDeclarationWarnings("container", "containers", inferred.containers),
+    ...unexportedDeclarationWarnings("workflow", "workflows", inferred.workflows),
+    ...unexportedDeclarationWarnings("agent", "agents", inferred.agents)
+  );
   if (inferred.containers.length > 0 && parsed?.observability?.enabled === false) {
     warnings.push("containers are declared but observability is explicitly disabled in wrangler.jsonc — container logs will not be captured.");
   }
@@ -225,15 +224,26 @@ const reconcileObservability = (text, parsed) => {
 const workflowEntryFor = (workflow) => {
   return { binding: workflow.bindingName, class_name: workflow.className, name: workflow.name };
 };
-const reconcileWorkflows = (text, parsed, workflows) => {
+const agentEntryFor = (agent) => {
+  return { binding: agent.bindingName, class_name: agent.className, name: agent.name };
+};
+const reconcileWorkflows = (text, parsed, workflows, agents = []) => {
   const existing = parsed.workflows ?? [];
   const existingClasses = new Set(existing.map((entry) => entry.class_name));
-  const missing = workflows.filter((workflow) => !existingClasses.has(workflow.className));
-  if (missing.length === 0) {
+  const missingWorkflows = workflows.filter((workflow) => !existingClasses.has(workflow.className));
+  const missingAgents = agents.filter((agent) => !existingClasses.has(agent.className));
+  if (missingWorkflows.length === 0 && missingAgents.length === 0) {
     return { added: [], text };
   }
-  const nextText = applyModify(text, ["workflows"], [...existing, ...missing.map((workflow) => workflowEntryFor(workflow))]);
-  return { added: missing.map((workflow) => `workflows/${workflow.className}`), text: nextText };
+  const nextText = applyModify(
+    text,
+    ["workflows"],
+    [...existing, ...missingWorkflows.map((workflow) => workflowEntryFor(workflow)), ...missingAgents.map((agent) => agentEntryFor(agent))]
+  );
+  return {
+    added: [...missingWorkflows.map((workflow) => `workflows/${workflow.className}`), ...missingAgents.map((agent) => `workflows/${agent.className}`)],
+    text: nextText
+  };
 };
 const reconcileQueues = (text, parsed, queues) => {
   const existing = parsed.queues ?? {};
@@ -298,13 +308,20 @@ const reconcileWranglerBindings = (projectRoot, inferred) => {
   }
   const warnings = collectWarnings(inferred, parsed);
   const exportedContainers = inferred.containers.filter((container) => container.exported);
+  const voiceAgents = inferred.agents.filter(
+    (agent) => agent.exported && agent.voice === true && agent.voiceBindingName !== void 0 && agent.voiceClassName !== void 0
+  );
   const requiredDurableObjects = [
     ...inferred.durableObjects,
     ...exportedContainers.map((container) => {
       return { binding: container.bindingName, className: container.className };
+    }),
+    ...voiceAgents.map((agent) => {
+      return { binding: agent.voiceBindingName, className: agent.voiceClassName };
     })
   ];
   const exportedWorkflows = inferred.workflows.filter((workflow) => workflow.exported);
+  const exportedAgents = inferred.agents.filter((agent) => agent.exported);
   const pipeline = [
     { enabled: true, run: (text2) => reconcileDurableObjects(text2, parsed, requiredDurableObjects) },
     { enabled: inferred.needsD1, run: (text2) => reconcileD1(text2, parsed) },
@@ -314,7 +331,10 @@ const reconcileWranglerBindings = (projectRoot, inferred) => {
     { enabled: inferred.usesAnalytics, run: (text2) => reconcileAnalytics(text2, parsed) },
     { enabled: true, run: (text2) => reconcileObservability(text2, parsed) },
     { enabled: exportedContainers.length > 0, run: (text2) => reconcileContainers(text2, parsed, exportedContainers) },
-    { enabled: exportedWorkflows.length > 0, run: (text2) => reconcileWorkflows(text2, parsed, exportedWorkflows) },
+    {
+      enabled: exportedWorkflows.length > 0 || exportedAgents.length > 0,
+      run: (text2) => reconcileWorkflows(text2, parsed, exportedWorkflows, exportedAgents)
+    },
     { enabled: inferred.queues.length > 0, run: (text2) => reconcileQueues(text2, parsed, inferred.queues) }
   ];
   let text = original;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/config",
-  "version": "1.0.0-alpha.65",
+  "version": "1.0.0-alpha.67",
   "description": "Internal shared CLI + Vite config layer for Lunora: wrangler.jsonc validation, binding inference, and .dev.vars scaffolding",
   "keywords": [
     "bindings",
@@ -50,10 +50,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/codegen": "1.0.0-alpha.42",
+    "@lunora/codegen": "1.0.0-alpha.43",
     "@lunora/container": "1.0.0-alpha.11",
     "@lunora/errors": "1.0.0-alpha.4",
-    "@lunora/seed": "1.0.0-alpha.22",
+    "@lunora/seed": "1.0.0-alpha.23",
     "@visulima/colorize": "2.0.0",
     "@visulima/find-ai-runner": "1.0.0",
     "dockerode": "^5.0.1",
@@ -62,7 +62,7 @@
     "ts-morph": "^28.0.0"
   },
   "peerDependencies": {
-    "@lunora/studio": "1.0.0-alpha.48"
+    "@lunora/studio": "1.0.0-alpha.50"
   },
   "peerDependenciesMeta": {
     "@lunora/studio": {