feat(protocol): reconcile SDK protocol with factory-mono-alpha (add commands/crons, retire loop RPCs) (#60)

* feat(protocol): reconcile SDK protocol with factory-mono-alpha

Adds slash-command + cron schemas, retires the DaemonLoop RPC family
per FAC-19606, bumps FACTORY_PROTOCOL_VERSION to 1.66.0, and aligns
wire-level constants with mono. Version bumped 0.5.0 -> 0.6.0.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

* feat(protocol): add ./protocol subpath export

Adds a dedicated './protocol' subpath export so consumers can import
the wire-protocol schemas directly without pulling the full SDK
surface:

  import { daemon } from '@factory/droid-sdk/protocol';

Builds a separate dist/protocol/index.{js,cjs,d.ts,d.cts} via tsup.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

* feat(protocol): reconcile schemas with factory-mono-alpha source of truth

Adds missing fields/enum members detected by mono's verify-sdk-parity
audit so the SDK is bit-equivalent to mono's wire schemas:

- enums.ts: add ModelID entries ORIEL_0601, OXIDE_0601, OXBOW_0601,
  OCELOT_0601 (Olympus families released after the previous port).
- general-settings.ts: add McpAutonomyUrlOverrideSchema +
  mcpAutonomyUrlOverrides on ManagedSettingsBaseSchema, and
  dismissedNewModels on GeneralSettingsSchema.
- daemon/droid.ts:
  - DaemonGetGitDiffDataSchema: add committedDiff / committedFiles /
    committedTotalAdditions / committedTotalDeletions for the
    committed-only diff section the frontend renders.
  - DaemonGetGitDiffRequestParamsSchema: add statsOnly.
  - DaemonGetWorkspaceFileContentRequestParamsSchema: add encoding
    (utf8|base64) for binary file previews.
  - DaemonGetWorkspaceFileContentResultSchema: add encoding, mimeType,
    isBinary so the frontend can guard binary content properly.

After this change factory-mono-alpha reports 265/265 schema MATCH and
0 MISMATCH against @factory/droid-sdk/protocol.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

* chore(protocol): scrub internal references from public schemas

Strips internal-architecture references from src/protocol/** so they
no longer leak into the published bundles and source-maps:

- Remove file headers referencing the internal monorepo and verbatim
  port provenance from ~30 protocol files; replace with neutral
  one-line descriptions where useful.
- Scrub billing/architecture JSDoc on WorkerFailureReason and
  MissionPauseReason (the enum members are unchanged; only the
  descriptive comments around them are tightened).
- Drop the editorial 'Deprecated' / 'Extra Usage (overage) billing
  tier' comments from LLMModelTier members.
- Drop incidental references to internal infra (Vercel, Firestore
  sync, EAP cleanup, backend-v0-sessions, replay bug #974,
  MissionRunner / MissionFileService class names) from JSDoc and
  inline comments.
- Add *.tgz to .gitignore so packed builds aren't accidentally
  committed.

No schema, enum value, or exported symbol shape changes; bundle
parity against mono is unaffected (still 265/265 MATCH).

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

---------

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

Author: varin-nair-factory

.gitignore

@@ -3,6 +3,7 @@ node_modules/
 
 # Build output
 dist/
+*.tgz
 
 # Coverage
 coverage/

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@factory/droid-sdk",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": false,
   "description": "TypeScript SDK for the Factory Droid CLI",
   "keywords": [
@@ -26,6 +26,16 @@
         "types": "./dist/index.d.cts",
         "default": "./dist/index.cjs"
       }
+    },
+    "./protocol": {
+      "import": {
+        "types": "./dist/protocol/index.d.ts",
+        "default": "./dist/protocol/index.js"
+      },
+      "require": {
+        "types": "./dist/protocol/index.d.cts",
+        "default": "./dist/protocol/index.cjs"
+      }
     }
   },
   "files": [

package.json

@@ -1,6 +1,3 @@
-// Source-of-truth mirror of factory-mono-alpha CLI protocol schemas.
-// Verbatim copy of packages/common/src/droid/schemas/cli.ts.
-
 import { z } from 'zod';
 
 import { SandboxModeSchema } from './custom-models.js';

src/protocol/cli.ts

@@ -1,6 +1,3 @@
-// Source-of-truth mirror of factory-mono-alpha client protocol schemas.
-// Verbatim copy of packages/common/src/droid/schemas/client.ts.
-
 import { z } from 'zod';
 
 import {
@@ -689,6 +686,26 @@ export const ListSkillsRequestSchema = JsonRpcBaseRequestSchema.extend({
   params: ListSkillsRequestParamsSchema,
 });
 
+// List commands request (returns all custom slash commands)
+const ListCommandsRequestParamsSchema = z.object({});
+
+export const CustomCommandInfoSchema = z.object({
+  name: z.string(),
+  description: z.string(),
+  argumentHint: z.string().optional(),
+  // Whether the command is backed by an executable script (resolution runs it)
+  isExecutable: z.boolean().optional(),
+});
+
+const ListCommandsResultSchema = z.object({
+  commands: z.array(CustomCommandInfoSchema),
+});
+
+export const ListCommandsRequestSchema = JsonRpcBaseRequestSchema.extend({
+  method: z.literal(DroidServerMethod.LIST_COMMANDS),
+  params: ListCommandsRequestParamsSchema,
+});
+
 const GetContextStatsRequestParamsSchema = z.object({});
 
 export { ContextStatsSchema as GetContextStatsResultSchema };
@@ -917,6 +934,7 @@ export const ClientRequestSchema = z.discriminatedUnion('method', [
   ToggleMcpToolRequestSchema,
   SubmitMcpAuthCodeRequestSchema,
   ListSkillsRequestSchema,
+  ListCommandsRequestSchema,
   GetContextStatsRequestSchema,
   GetContextBreakdownRequestSchema,
   SubmitBugReportRequestSchema,
@@ -1068,6 +1086,13 @@ export const ListSkillsResponseSchema = z.union([
   JsonRpcBaseResponseFailureSchema,
 ]);
 
+export const ListCommandsResponseSchema = z.union([
+  JsonRpcBaseResponseSuccessSchema.extend({
+    result: ListCommandsResultSchema,
+  }),
+  JsonRpcBaseResponseFailureSchema,
+]);
+
 export const GetContextStatsResponseSchema = z.union([
   JsonRpcBaseResponseSuccessSchema.extend({
     result: ContextStatsSchema,

src/protocol/client.ts

@@ -1,8 +1,8 @@
-// Source-of-truth mirror of factory-mono-alpha protocol constants.
-// Faithful copy of:
-//   packages/common/src/droid/schemas/constants.ts
-//   packages/common/src/droid/constants.ts (LOOP_INTERVAL_POLICY)
-// Keep shapes/values identical to the private monorepo to avoid protocol drift.
+import { DroidWorkingState } from './enums.js';
+
+export const FACTORY_CLIENT_HEADER = 'X-Factory-Client';
+export const FACTORY_CLIENT_VERSION = 'X-Client-Version';
+export const ACTIVE_ORGANIZATION_HEADER = 'X-Factory-Org-Id';
 
 /**
  * Legacy envelope field for old JSON-RPC peers - `factoryApiVersion` must be set to this value.
@@ -11,39 +11,60 @@
  */
 export const LEGACY_FACTORY_API_VERSION = '1.0.0' as const;
 
-export const FACTORY_PROTOCOL_VERSION = '1.62.0' as const;
+export const FACTORY_PROTOCOL_VERSION = '1.66.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.
+ * Sentinel ModelID value for the Factory routing model.
  */
 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.
+ * current model for compaction".
  */
 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;
 
+/**
+ * System reminder tag constants used for marking content as hidden from users.
+ */
+export const SYSTEM_REMINDER_START = '<system-reminder>';
+export const SYSTEM_REMINDER_END = '</system-reminder>';
+
+/**
+ * System notification tag constants used for marking notifications as hidden from users.
+ */
+export const SYSTEM_NOTIFICATION_START = '<system-notification>';
+export const SYSTEM_NOTIFICATION_END = '</system-notification>';
+
+export const EXIT_SPEC_MODE_REJECTED_MESSAGE =
+  'Plan not approved - remaining in Spec Mode. Provide feedback to refine the spec.';
+
 const seconds = (value: number) => value * 1_000;
 const minutes = (value: number) => seconds(value * 60);
 const hours = (value: number) => minutes(value * 60);
 
 export const LOOP_INTERVAL_POLICY = {
-  minMs: seconds(5),
+  minMs: minutes(1),
   maxMs: hours(24),
-  displayRange: '5s–24h',
-  examples: '5s, 5m, 30m, 2h',
+  displayRange: '1m–24h',
+  examples: '5m, 30m, 2h',
 } as const;
+
+const DROID_RUNNING_STATES = [
+  DroidWorkingState.Thinking,
+  DroidWorkingState.StreamingAssistantMessage,
+  DroidWorkingState.ExecutingTool,
+  DroidWorkingState.CompactingConversation,
+];
+export const DROID_IN_PROGRESS_STATES = [
+  ...DROID_RUNNING_STATES,
+  DroidWorkingState.WaitingForToolConfirmation,
+];

src/protocol/constants.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+
+const CronExpressionSchema = z
+  .string()
+  .trim()
+  .regex(/^(\S+\s+){4}\S+$/, 'Expected a standard 5-field cron expression');
+
+export const CronCreateToolInputSchema = z.object({
+  expression: CronExpressionSchema.describe(
+    'Standard 5-field cron expression in local time.'
+  ),
+  job: z.object({
+    type: z.literal('prompt'),
+    prompt: z.string().trim().min(1),
+  }),
+  target: z
+    .object({
+      type: z.literal('same_session'),
+    })
+    .optional(),
+  recurring: z.boolean().describe('true for recurring tasks, false for once'),
+});
+
+export const CronDeleteToolInputSchema = z.object({
+  cronId: z.string().length(8),
+});
+
+export const CronListToolInputSchema = z.object({});

src/protocol/crons.ts

@@ -1,8 +1,5 @@
-// Source-of-truth mirror of factory-mono-alpha custom-model schemas (symbol-only).
-// Verbatim copy of CustomModelBedrockSchema, ManagedCustomModelSchema, and
-// CustomModelsSchema from packages/common/src/settings/schema.ts. Ported as-is
-// per the no-modification rule (includes apiKey / aws credential fields).
-// SandboxModeSchema is colocated here (one-liner from the same settings module).
+// Custom-model schemas (includes apiKey / aws credential fields).
+// SandboxModeSchema is colocated here.
 
 import { z } from 'zod';
 

src/protocol/custom-models.ts

@@ -16,9 +16,9 @@ export const DaemonListAutomationsRequestSchema =
   });
 
 export const AutomationEntrySchema = z.object({
-  /** Directory name slug (e.g. "health-check"). Kept as `id` because protocol rules forbid renaming required fields. */
+  /** Directory name slug (e.g. "health-check"). */
   id: z.string(),
-  /** Stable UUID from HEARTBEAT.md frontmatter, used for backend/Firestore sync. */
+  /** Stable UUID for backend sync. */
   uuid: z.string().optional(),
   name: z.string(),
   description: z.string().optional(),

src/protocol/daemon/automations.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+
+import { CustomCommandInfoSchema } from '../client.js';
+import { JsonRpcBaseRequestSchema } from '../json-rpc.js';
+import { DaemonDroidMethod } from './enums.js';
+
+// LIST_COMMANDS - get all custom slash commands for a session
+const DaemonListCommandsRequestParamsSchema = z.object({
+  sessionId: z.string(),
+});
+
+export const DaemonListCommandsRequestSchema = JsonRpcBaseRequestSchema.extend({
+  method: z.literal(DaemonDroidMethod.LIST_COMMANDS),
+  params: DaemonListCommandsRequestParamsSchema,
+});
+
+export const DaemonListCommandsResultSchema = z.object({
+  commands: z.array(CustomCommandInfoSchema),
+});