Factory-AI
diff --git a/‎src/index.ts‎
Lines changed: 6 additions & 0 deletions b/‎src/index.ts‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎src/protocol/automations-enums.ts‎
Lines changed: 50 additions & 0 deletions b/‎src/protocol/automations-enums.ts‎
Lines changed: 50 additions & 0 deletions
diff --git a/‎src/protocol/automations.ts‎
Lines changed: 34 additions & 0 deletions b/‎src/protocol/automations.ts‎
Lines changed: 34 additions & 0 deletions
diff --git a/‎src/protocol/constants.ts‎
Lines changed: 22 additions & 0 deletions b/‎src/protocol/constants.ts‎
Lines changed: 22 additions & 0 deletions
diff --git a/‎src/protocol/daemon/automations-enums.ts‎
Lines changed: 4 additions & 0 deletions b/‎src/protocol/daemon/automations-enums.ts‎
Lines changed: 4 additions & 0 deletions
@@ -16,6 +16,12 @@ export type {
   PermissionHandler,
 } from './protocol.js';
 
+// Namespace export for the source-of-truth protocol schemas under src/protocol/.
+// Exposed as a namespace to avoid colliding with the flat exports above from
+// the legacy `./protocol.js` file. Consumers access these as
+// `protocol.DaemonRequestSchema`, `protocol.daemon.…`, `protocol.usage.…`, etc.
+export * as protocol from './protocol/index.js';
+
 export { DroidClient } from './client.js';
 export type {
   ClientAskUserHandler,
 
@@ -0,0 +1,50 @@
+/** Named schedule cadences */
+export enum AutomationScheduleCadence {
+  Daily = 'daily',
+  Weekly = 'weekly',
+  Monthly = 'monthly',
+}
+
+/** Types of validation issues */
+export enum AutomationValidationIssueType {
+  MissingFile = 'missing_file',
+  InvalidFrontmatter = 'invalid_frontmatter',
+  InvalidSchedule = 'invalid_schedule',
+  ParseError = 'parse_error',
+}
+
+// =============================================================================
+// Control-plane enums
+// =============================================================================
+
+/**
+ * Control-plane error codes.
+ *
+ * These codes enable deterministic error handling across CLI/desktop surfaces.
+ */
+export enum AutomationErrorCode {
+  /** Automation with the given ID was not found */
+  NotFound = 'AUTOMATION_NOT_FOUND',
+  /** Automation already exists with the given ID */
+  AlreadyExists = 'AUTOMATION_ALREADY_EXISTS',
+  /** Invalid automation ID format */
+  InvalidId = 'INVALID_AUTOMATION_ID',
+  /** Invalid configuration (e.g., invalid schedule) */
+  InvalidConfig = 'INVALID_AUTOMATION_CONFIG',
+  /** Automation is already in the requested state */
+  AlreadyInState = 'ALREADY_IN_STATE',
+  /** A run is already in progress for this automation */
+  RunInProgress = 'RUN_IN_PROGRESS',
+  /** Heartbeat execution failed */
+  ExecutionFailed = 'EXECUTION_FAILED',
+  /** General internal error */
+  InternalError = 'INTERNAL_ERROR',
+}
+
+/** Privacy level for an automation */
+export enum AutomationPrivacyLevel {
+  /** Only visible to the creator */
+  Private = 'private',
+  /** Visible to all members of the organization */
+  Organization = 'organization',
+}
@@ -0,0 +1,34 @@
+import { z } from 'zod';
+
+import { AutomationPrivacyLevel } from './automations-enums.js';
+
+export const AutomationCreatedBySchema = z.object({
+  name: z.string(),
+  email: z.string().optional(),
+  avatarUrl: z.string().optional(),
+});
+
+export type AutomationCreatedBy = z.infer<typeof AutomationCreatedBySchema>;
+
+/**
+ * Schema for the on-disk YAML metadata in HEARTBEAT.md frontmatter.
+ *
+ * This is the flat representation stored between `---` delimiters.
+ * Differs from AutomationConfig in that `schedule` is a plain string
+ * (e.g. "daily", "0 9 * * 1-5") rather than the runtime
+ * `{ cadence: string }` shape.
+ */
+export const AutomationsHeartbeatSchema = z.object({
+  id: z.string().uuid().optional(),
+  name: z.string(),
+  description: z.string().optional(),
+  schedule: z.string(),
+  model: z.string().optional(),
+  tags: z.array(z.string()).optional(),
+  paused: z.boolean().optional(),
+  privacyLevel: z.nativeEnum(AutomationPrivacyLevel).optional(),
+  createdBy: AutomationCreatedBySchema.optional(),
+  forkedFrom: z.string().optional(),
+});
+
+export type AutomationsHeartbeat = z.infer<typeof AutomationsHeartbeatSchema>;
@@ -15,6 +15,28 @@ export const FACTORY_PROTOCOL_VERSION = '1.62.0' as const;
 
 export const JSONRPC_VERSION = '2.0' as const;
 
+/**
+ * Sentinel ModelID value for the Factory routing model. Faithful copy of
+ * packages/common/src/llm/constants.ts.
+ */
+export const FACTORY_ROUTER_MODEL_ID = 'factory-router' as const;
+
+/**
+ * Sentinel value used by CompactionModelSchema to mean "use the session's
+ * current model for compaction". Faithful copy of
+ * packages/common/src/settings/constants.ts.
+ */
+export const CURRENT_COMPACTION_MODEL = 'current-model';
+
+// Faithful copy of packages/common/src/settings/constants.ts router-rule
+// guardrails. Used by ManagedSettingsBaseSchema and FactoryRouterRuleSchema.
+
+/** Sized comparably to a trimmed user message in the classifier context budget. */
+export const FACTORY_ROUTER_GUIDANCE_MAX_LENGTH = 2000;
+export const FACTORY_ROUTER_RULES_MAX_COUNT = 20;
+export const FACTORY_ROUTER_RULE_WHEN_MAX_LENGTH = 300;
+export const FACTORY_ROUTER_RULE_GUIDANCE_MAX_LENGTH = 600;
+
 const seconds = (value: number) => value * 1_000;
 const minutes = (value: number) => seconds(value * 60);
 const hours = (value: number) => minutes(value * 60);
 
@@ -0,0 +1,4 @@
+// Re-export from the hoisted top-level automations enums module so daemon
+// consumers continue to import `AutomationPrivacyLevel` from this path while
+// the canonical definition lives at `src/protocol/automations-enums.ts`.
+export * from '../automations-enums.js';