@factory/droid-sdk 0.3.0 → 0.5.0

package/docs/sdk-usage-guide.md

@@ -6,12 +6,13 @@
 npm install @factory/droid-sdk
 ```
 
-Requires Node.js 18+ and the `droid` CLI on your PATH.
+Requires Node.js 18+ and the `droid` CLI on your PATH. This guide covers **exec mode** (`run()`, `createSession()`), which spawns a subprocess per session. For WebSocket-based daemon mode with concurrent sessions, see the [Daemon Usage Guide](./daemon-usage-guide.md).
 
 ```ts
 import { run } from '@factory/droid-sdk';
 
 const result = await run('What files are in this directory?', {
+  apiKey: process.env.FACTORY_API_KEY!,
   cwd: process.cwd(),
 });
 console.log(result.text);
@@ -26,7 +27,10 @@ Send a prompt, get a result, done. The session is created and closed automatical
 ```ts
 import { run } from '@factory/droid-sdk';
 
-const result = await run('What is 2 + 2?', { cwd: process.cwd() });
+const result = await run('What is 2 + 2?', {
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 console.log(result.text);
 ```
 
@@ -38,6 +42,7 @@ Force the response to match a JSON schema. The validated object is available on
 import { OutputFormatType, run } from '@factory/droid-sdk';
 
 const result = await run('Pick a number between 1 and 42.', {
+  apiKey: process.env.FACTORY_API_KEY!,
   cwd: process.cwd(),
   outputFormat: {
     type: OutputFormatType.JsonSchema,
@@ -57,16 +62,19 @@ console.log((result.structuredOutput as { number: number }).number);
 Create a session once, then call `stream()` multiple times. Context is preserved across turns.
 
 ```ts
-import { createSession } from '@factory/droid-sdk';
+import { createSession, DroidMessageType } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 
 for await (const msg of session.stream('Remember the word "mango".')) {
   // consume first turn
 }
 
 for await (const msg of session.stream('What word did I say?')) {
-  if (msg.type === 'assistant') console.log(msg.text);
+  if (msg.type === DroidMessageType.Assistant) console.log(msg.text);
 }
 
 await session.close();
@@ -77,12 +85,14 @@ await session.close();
 Reconnect to a previously created session by its ID.
 
 ```ts
-import { resumeSession } from '@factory/droid-sdk';
+import { resumeSession, DroidMessageType } from '@factory/droid-sdk';
 
-const session = await resumeSession('existing-session-id');
+const session = await resumeSession('existing-session-id', {
+  apiKey: process.env.FACTORY_API_KEY!,
+});
 
 for await (const msg of session.stream('Continue where we left off.')) {
-  if (msg.type === 'assistant') console.log(msg.text);
+  if (msg.type === DroidMessageType.Assistant) console.log(msg.text);
 }
 
 await session.close();
@@ -95,7 +105,10 @@ await session.close();
 ```ts
 import { createSession, DroidMessageType } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 
 for await (const msg of session.stream(
   'List files in the current directory.'
@@ -126,7 +139,10 @@ Enable `includePartialMessages` to get token-by-token deltas, thinking blocks, a
 ```ts
 import { createSession, DroidMessageType } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 
 for await (const msg of session.stream('Explain recursion.', {
   includePartialMessages: true,
@@ -144,19 +160,25 @@ await session.close();
 Use `session.interrupt()` to stop the current turn server-side, or pass an `AbortSignal` to cancel from the client.
 
 ```ts
-import { createSession } from '@factory/droid-sdk';
+import { createSession, DroidMessageType } from '@factory/droid-sdk';
 
 // Interrupt after receiving some output
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 for await (const msg of session.stream('Write a long essay.')) {
-  if (msg.type === 'assistant') {
+  if (msg.type === DroidMessageType.Assistant) {
     await session.interrupt();
   }
 }
 await session.close();
 
 // Or cancel with AbortSignal
-const session2 = await createSession({ cwd: process.cwd() });
+const session2 = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 const controller = new AbortController();
 setTimeout(() => controller.abort(), 2000);
 
@@ -179,6 +201,7 @@ Define custom tools that Droid can call during a session. Tools are served via a
 import {
   createSession,
   createSdkMcpServer,
+  DroidMessageType,
   tool,
   ToolConfirmationOutcome,
 } from '@factory/droid-sdk';
@@ -199,13 +222,14 @@ const server = createSdkMcpServer({
 });
 
 const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
   cwd: process.cwd(),
   mcpServers: [server],
   permissionHandler: () => ToolConfirmationOutcome.ProceedOnce,
 });
 
 for await (const msg of session.stream('Look up Alice.')) {
-  if (msg.type === 'assistant') console.log(msg.text);
+  if (msg.type === DroidMessageType.Assistant) console.log(msg.text);
 }
 
 await session.close();
@@ -219,6 +243,7 @@ Control what Droid can do without asking for permission. Set at session creation
 import { createSession, AutonomyLevel } from '@factory/droid-sdk';
 
 const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
   cwd: process.cwd(),
   autonomyLevel: AutonomyLevel.High, // Off | Low | Medium | High
 });
@@ -236,6 +261,7 @@ Restrict which tools Droid can use. Accepts tool IDs like `'Read'`, `'Execute'`,
 import { createSession } from '@factory/droid-sdk';
 
 const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
   cwd: process.cwd(),
   enabledToolIds: ['Read', 'Grep'],
   disabledToolIds: ['Execute'],
@@ -258,6 +284,7 @@ import {
 } from '@factory/droid-sdk';
 
 await run('Create hello.txt with "Hello, World!"', {
+  apiKey: process.env.FACTORY_API_KEY!,
   cwd: process.cwd(),
   permissionHandler(params) {
     const safe = params.toolUses.every(
@@ -283,6 +310,7 @@ import {
 } from '@factory/droid-sdk';
 
 const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
   cwd: process.cwd(),
   interactionMode: DroidInteractionMode.Spec,
   permissionHandler(params) {
@@ -306,9 +334,12 @@ Send images or documents alongside your prompt. Images must be base64-encoded.
 
 ```ts
 import { readFileSync } from 'node:fs';
-import { createSession } from '@factory/droid-sdk';
+import { createSession, DroidMessageType } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 
 for await (const msg of session.stream('Describe this image.', {
   images: [
@@ -319,7 +350,7 @@ for await (const msg of session.stream('Describe this image.', {
     },
   ],
 })) {
-  if (msg.type === 'assistant') console.log(msg.text);
+  if (msg.type === DroidMessageType.Assistant) console.log(msg.text);
 }
 
 await session.close();
@@ -330,17 +361,26 @@ await session.close();
 Create a copy of the current session with all context preserved. Useful for branching a conversation.
 
 ```ts
-import { createSession, resumeSession } from '@factory/droid-sdk';
+import {
+  createSession,
+  DroidMessageType,
+  resumeSession,
+} from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 for await (const msg of session.stream('Remember: the password is "banana".')) {
 }
 
 const { newSessionId } = await session.forkSession();
-const fork = await resumeSession(newSessionId);
+const fork = await resumeSession(newSessionId, {
+  apiKey: process.env.FACTORY_API_KEY!,
+});
 
 for await (const msg of fork.stream('What is the password?')) {
-  if (msg.type === 'assistant') console.log(msg.text);
+  if (msg.type === DroidMessageType.Assistant) console.log(msg.text);
 }
 
 await fork.close();
@@ -354,7 +394,10 @@ Summarize and remove old messages to free up context window space.
 ```ts
 import { createSession } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 
 // ... after many turns ...
 const result = await session.compactSession();
@@ -376,7 +419,10 @@ import {
   AutonomyLevel,
 } from '@factory/droid-sdk';
 
-const transport = new ProcessTransport({ cwd: process.cwd() });
+const transport = new ProcessTransport({
+  cwd: process.cwd(),
+  env: { FACTORY_API_KEY: process.env.FACTORY_API_KEY! },
+});
 await transport.connect();
 const client = new DroidClient({ transport });
 
@@ -423,6 +469,7 @@ Choose which model to use and how much reasoning effort to apply. Configurable a
 import { createSession, ReasoningEffort } from '@factory/droid-sdk';
 
 const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
   cwd: process.cwd(),
   modelId: 'claude-sonnet-4-20250514',
   reasoningEffort: ReasoningEffort.High,
@@ -443,7 +490,10 @@ Observe file hooks (pre/post tool execution hooks) as they run during a session.
 ```ts
 import { createSession, DroidMessageType } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 
 for await (const msg of session.stream('Create a new file.')) {
   if (msg.type === DroidMessageType.Hook) {
@@ -463,9 +513,10 @@ await session.close();
 Programmatically answer questions that Droid asks the user during execution.
 
 ```ts
-import { createSession } from '@factory/droid-sdk';
+import { createSession, DroidMessageType } from '@factory/droid-sdk';
 
 const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
   cwd: process.cwd(),
   askUserHandler(params) {
     return {
@@ -480,7 +531,7 @@ const session = await createSession({
 });
 
 for await (const msg of session.stream('Help me set up this project.')) {
-  if (msg.type === 'assistant') console.log(msg.text);
+  if (msg.type === DroidMessageType.Assistant) console.log(msg.text);
 }
 
 await session.close();
@@ -493,7 +544,10 @@ Add, remove, toggle, and list MCP servers at runtime within an active session.
 ```ts
 import { createSession, McpServerType } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 
 await session.addMcpServer({
   name: 'my-server',
@@ -514,7 +568,10 @@ Query current context window usage to understand how much capacity remains.
 ```ts
 import { createSession } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 for await (const msg of session.stream('Hello')) {
 }
 
@@ -533,7 +590,10 @@ Monitor token consumption in real-time via stream events, or read the final tota
 ```ts
 import { createSession, DroidMessageType } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 
 for await (const msg of session.stream('Summarize this project.', {
   includePartialMessages: true,
@@ -558,7 +618,10 @@ List all available skills in the current session.
 ```ts
 import { createSession } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 const { skills } = await session.listSkills();
 
 for (const skill of skills) {
@@ -575,7 +638,10 @@ Subscribe to raw protocol notifications for custom event handling beyond the str
 ```ts
 import { createSession, SessionNotificationType } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 
 const unsubscribe = session.onNotification(
   (notification) => {
@@ -604,7 +670,9 @@ import {
 } from '@factory/droid-sdk';
 
 try {
-  const session = await resumeSession('nonexistent-id');
+  const session = await resumeSession('nonexistent-id', {
+    apiKey: process.env.FACTORY_API_KEY!,
+  });
 } catch (error) {
   if (error instanceof SessionNotFoundError) {
     console.log(`Session not found: ${error.sessionId}`);
@@ -634,6 +702,7 @@ The package also exports its full Zod schema surface from `src/schemas/index.ts`
 
 | Field                     | Type                     | Description                                                 |
 | :------------------------ | :----------------------- | :---------------------------------------------------------- |
+| `apiKey`                  | `string`                 | **Required.** Factory API key for authentication            |
 | `cwd`                     | `string`                 | Working directory for the session                           |
 | `machineId`               | `string`                 | Machine identifier for initialization                       |
 | `modelId`                 | `string`                 | LLM model identifier                                        |
@@ -646,6 +715,7 @@ The package also exports its full Zod schema surface from `src/schemas/index.ts`
 | `enabledToolIds`          | `string[]`               | Tool allowlist                                              |
 | `disabledToolIds`         | `string[]`               | Tool denylist                                               |
 | `tags`                    | `SessionTag[]`           | Session tags for categorization                             |
+| `sessionSource`           | `SessionSource`          | Attribution metadata (e.g., integration origin)             |
 | `permissionHandler`       | `PermissionHandler`      | Tool confirmation callback                                  |
 | `askUserHandler`          | `AskUserHandler`         | Structured user-input callback                              |
 | `execPath`                | `string`                 | Path to `droid` executable (default: `"droid"`)             |

package/examples/abort-session-stream.ts

@@ -7,7 +7,10 @@
 
 import { createSession } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 const controller = new AbortController();
 const timeout = setTimeout(
   () => controller.abort(new Error('Stopped by AbortController')),

package/examples/daemon-multi-session.ts

@@ -0,0 +1,67 @@
+/**
+ * Manual smoke test for the daemon SDK — multiple concurrent sessions.
+ *
+ * Spawns a local daemon, creates two sessions in separate /tmp directories,
+ * and runs them concurrently over a single WebSocket connection.
+ *
+ * Usage:
+ *   npx tsx examples/daemon-multi-session.ts
+ */
+
+import { connectDaemon, DroidMessageType } from '@factory/droid-sdk';
+
+async function main(): Promise<void> {
+  console.log('Connecting to local daemon...\n');
+  const daemon = await connectDaemon({ apiKey: process.env.FACTORY_API_KEY! });
+  console.log('Connected!\n');
+
+  const frontend = await daemon.createSession({
+    cwd: '/tmp/daemon-test-frontend',
+  });
+  const backend = await daemon.createSession({
+    cwd: '/tmp/daemon-test-backend',
+  });
+
+  console.log('Two sessions created. Running concurrently...\n');
+
+  await Promise.all([
+    (async () => {
+      for await (const msg of frontend.stream(
+        'Create a file called hello.md with a short greeting message. Just a few lines.'
+      )) {
+        if (msg.type === DroidMessageType.Assistant) {
+          process.stdout.write(`[frontend] ${msg.text}\n`);
+        } else if (msg.type === DroidMessageType.ToolCall) {
+          console.log(`[frontend] [tool] ${msg.toolUse.name}`);
+        } else if (msg.type === DroidMessageType.Result) {
+          console.log(`[frontend] Done in ${msg.durationMs}ms`);
+        }
+      }
+      await frontend.close();
+    })(),
+    (async () => {
+      for await (const msg of backend.stream(
+        'Create a file called notes.md with 3 random fun facts. Keep it short.'
+      )) {
+        if (msg.type === DroidMessageType.Assistant) {
+          process.stdout.write(`[backend] ${msg.text}\n`);
+        } else if (msg.type === DroidMessageType.ToolCall) {
+          console.log(`[backend] [tool] ${msg.toolUse.name}`);
+        } else if (msg.type === DroidMessageType.Result) {
+          console.log(`[backend] Done in ${msg.durationMs}ms`);
+        }
+      }
+      await backend.close();
+    })(),
+  ]);
+
+  await daemon.close();
+  console.log(
+    '\nDone. Check /tmp/daemon-test-frontend/hello.md and /tmp/daemon-test-backend/notes.md'
+  );
+}
+
+main().catch((err: unknown) => {
+  console.error('Error:', err);
+  process.exit(1);
+});

package/examples/droid-dev-structured-output.ts

@@ -25,6 +25,7 @@ async function main(): Promise<void> {
       'Return only valid JSON and do not include markdown fences.',
     ].join(' '),
     {
+      apiKey: process.env.FACTORY_API_KEY!,
       execPath,
       cwd: process.cwd(),
     }

package/examples/fork-session.ts

@@ -21,7 +21,9 @@ async function streamText(
   prompt: string
 ): Promise<string> {
   let text = '';
-  for await (const msg of session.stream(prompt)) {
+  for await (const msg of session.stream(prompt, {
+    includePartialMessages: true,
+  })) {
     if (msg.type === DroidMessageType.AssistantTextDelta) {
       text += msg.text;
     }
@@ -30,7 +32,10 @@ async function streamText(
 }
 
 async function main(): Promise<void> {
-  const session = await createSession({ cwd: process.cwd() });
+  const session = await createSession({
+    apiKey: process.env.FACTORY_API_KEY!,
+    cwd: process.cwd(),
+  });
   let fork: Awaited<ReturnType<typeof resumeSession>> | null = null;
 
   try {
@@ -40,7 +45,9 @@ async function main(): Promise<void> {
     const { newSessionId } = await session.forkSession();
     console.log(`Forked session:   ${newSessionId}\n`);
 
-    fork = await resumeSession(newSessionId);
+    fork = await resumeSession(newSessionId, {
+      apiKey: process.env.FACTORY_API_KEY!,
+    });
 
     const result = await streamText(
       fork,

package/examples/hook-execution.ts

@@ -15,7 +15,13 @@ async function main(): Promise<void> {
   console.log(`Sending prompt: "${prompt}"\n`);
 
   // Note: To actually see hooks, you need to have hooks configured in your droid settings.
-  const session = await createSession({ cwd: process.cwd() });
+  const apiKey = process.env.FACTORY_API_KEY;
+  if (!apiKey) {
+    console.error('Set FACTORY_API_KEY environment variable.');
+    process.exit(1);
+  }
+
+  const session = await createSession({ apiKey, cwd: process.cwd() });
 
   try {
     for await (const msg of session.stream(prompt)) {

package/examples/init-metadata.ts

@@ -7,8 +7,13 @@
 
 import { createSession, resumeSession } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
-const resumed = await resumeSession(session.sessionId);
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
+const resumed = await resumeSession(session.sessionId, {
+  apiKey: process.env.FACTORY_API_KEY!,
+});
 
 console.log(`created session: ${session.sessionId}`);
 console.log(`resumed session: ${resumed.sessionId}`);

package/examples/interrupt-session.ts

@@ -7,13 +7,16 @@
 
 import { createSession, DroidMessageType } from '@factory/droid-sdk';
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 let deltaCount = 0;
 
 try {
-  for await (const msg of session.stream(
-    'Write a long history of computing.'
-  )) {
+  for await (const msg of session.stream('Write a long history of computing.', {
+    includePartialMessages: true,
+  })) {
     if (msg.type !== DroidMessageType.AssistantTextDelta) {
       continue;
     }

package/examples/multi-turn-session.ts

@@ -12,7 +12,9 @@ async function streamText(
   prompt: string
 ): Promise<string> {
   let text = '';
-  for await (const msg of session.stream(prompt)) {
+  for await (const msg of session.stream(prompt, {
+    includePartialMessages: true,
+  })) {
     if (msg.type === DroidMessageType.AssistantTextDelta) {
       text += msg.text;
     }
@@ -20,7 +22,10 @@ async function streamText(
   return text;
 }
 
-const session = await createSession({ cwd: process.cwd() });
+const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
+  cwd: process.cwd(),
+});
 
 try {
   console.log(`Session: ${session.sessionId}\n`);

package/examples/permission-handler.ts

@@ -20,6 +20,7 @@ const outputPath = join(tempDir, 'hello.txt');
 
 try {
   await run(`Create ${outputPath} with the text "Hello, World!"`, {
+    apiKey: process.env.FACTORY_API_KEY!,
     cwd: process.cwd(),
     permissionHandler(params) {
       const onlyCreatesExpectedFile = params.toolUses.every(

package/examples/readme-structured-output.ts

@@ -3,6 +3,7 @@ import { OutputFormatType, run } from '@factory/droid-sdk';
 type FavoriteNumber = { favoriteNumber: number };
 
 const result = await run('Pick a favorite number between 1 and 42.', {
+  apiKey: process.env.FACTORY_API_KEY!,
   cwd: process.cwd(),
   outputFormat: {
     type: OutputFormatType.JsonSchema,

package/examples/result-metadata.ts

@@ -22,6 +22,7 @@ async function main(): Promise<void> {
   console.log(`Sending prompt: "${prompt}"\n`);
 
   const result = await run(prompt, {
+    apiKey: process.env.FACTORY_API_KEY!,
     cwd: process.cwd(),
   });
 

package/examples/run.ts

@@ -17,6 +17,7 @@ async function main(): Promise<void> {
   console.log(`Sending prompt: "${text}"\n`);
 
   const result = await run(text, {
+    apiKey: process.env.FACTORY_API_KEY!,
     cwd: process.cwd(),
   });
 

package/examples/sdk-mcp-tool.ts

@@ -22,6 +22,7 @@ const sdkTools = createSdkMcpServer({
 });
 
 const session = await createSession({
+  apiKey: process.env.FACTORY_API_KEY!,
   execPath,
   mcpServers: [sdkTools],
   cwd: process.cwd(),
@@ -30,7 +31,8 @@ const session = await createSession({
 
 try {
   for await (const msg of session.stream(
-    'Use the favorite_number tool for Ada and tell me the answer.'
+    'Use the favorite_number tool for Ada and tell me the answer.',
+    { includePartialMessages: true }
   )) {
     if (msg.type === DroidMessageType.AssistantTextDelta) {
       process.stdout.write(msg.text);

package/examples/session-stream.ts

@@ -15,7 +15,10 @@ async function main(): Promise<void> {
 
   console.log(`Sending prompt: "${prompt}"\n`);
 
-  const session = await createSession({ cwd: process.cwd() });
+  const session = await createSession({
+    apiKey: process.env.FACTORY_API_KEY!,
+    cwd: process.cwd(),
+  });
 
   try {
     for await (const msg of session.stream(prompt)) {

package/examples/spec-mode-new-session.ts

@@ -22,6 +22,7 @@ const outputPath = join(tempDir, 'hello.txt');
 
 try {
   const session = await createSession({
+    apiKey: process.env.FACTORY_API_KEY!,
     cwd: process.cwd(),
     interactionMode: DroidInteractionMode.Spec,
     specModeReasoningEffort: ReasoningEffort.High,

package/examples/spec-mode-same-session.ts

@@ -22,6 +22,7 @@ const outputPath = join(tempDir, 'hello.txt');
 
 try {
   const session = await createSession({
+    apiKey: process.env.FACTORY_API_KEY!,
     cwd: process.cwd(),
     interactionMode: DroidInteractionMode.Spec,
     specModeReasoningEffort: ReasoningEffort.High,

package/examples/structured-output.ts

@@ -38,6 +38,7 @@ async function main(): Promise<void> {
   console.log(`Sending prompt: "${prompt}"\n`);
 
   const result = await run(prompt, {
+    apiKey: process.env.FACTORY_API_KEY!,
     cwd: process.cwd(),
     outputFormat,
   });