@factory/droid-sdk 0.7.0 → 0.9.0

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

@@ -21,10 +21,13 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 
 import {
+  type ClientPermissionHandler,
   DroidInteractionMode,
+  DroidMessageType,
   ReasoningEffort,
   SessionNotificationSchema,
   ToolConfirmationOutcome,
+  ToolConfirmationType,
   createSession,
 } from '@factory/droid-sdk/node';
 
@@ -33,11 +36,38 @@ const outputPath = join(tempDir, 'hello.txt');
 
 let handoffSessionId: string | null = null;
 
+const handlePermissionRequest: ClientPermissionHandler = ({
+  toolUses,
+  options,
+}) => {
+  const exitsSpecMode =
+    toolUses.length > 0 &&
+    toolUses.every(
+      (toolUse) => toolUse.details.type === ToolConfirmationType.ExitSpecMode
+    );
+  const createsExpectedFile =
+    toolUses.length > 0 &&
+    toolUses.every(
+      (toolUse) =>
+        toolUse.details.type === ToolConfirmationType.Create &&
+        toolUse.details.filePath === outputPath
+    );
+
+  const outcome =
+    exitsSpecMode || createsExpectedFile
+      ? ToolConfirmationOutcome.ProceedOnce
+      : ToolConfirmationOutcome.Cancel;
+  if (!options.some((option) => option.value === outcome)) {
+    throw new Error(`Outcome not offered: ${outcome}`);
+  }
+  return outcome;
+};
+
 try {
   const session = await createSession({
     interactionMode: DroidInteractionMode.Spec,
     specModeReasoningEffort: ReasoningEffort.High,
-    permissionHandler: () => ToolConfirmationOutcome.ProceedOnce,
+    permissionHandler: handlePermissionRequest,
   });
 
   // The typed message stream carries no per-message session id, and the
@@ -54,10 +84,14 @@ try {
   });
 
   try {
-    for await (const _msg of session.stream(
+    for await (const message of session.stream(
       `Plan then create ${outputPath} containing "Hello from Droid".`
     )) {
-      // Consume the stream until implementation finishes.
+      if (message.type === DroidMessageType.Result && !message.success) {
+        throw new Error(
+          message.error?.message ?? `Turn ended: ${message.subtype}`
+        );
+      }
     }
   } finally {
     unsubscribe();

package/examples/node/structured-output.ts

@@ -19,6 +19,31 @@ interface CodeReview {
   }>;
 }
 
+function isCodeReview(value: unknown): value is CodeReview {
+  if (
+    value === null ||
+    typeof value !== 'object' ||
+    !('summary' in value) ||
+    typeof value.summary !== 'string' ||
+    !('findings' in value) ||
+    !Array.isArray(value.findings)
+  ) {
+    return false;
+  }
+
+  return value.findings.every(
+    (finding) =>
+      finding !== null &&
+      typeof finding === 'object' &&
+      'line' in finding &&
+      typeof finding.line === 'number' &&
+      'severity' in finding &&
+      ['low', 'medium', 'high'].includes(String(finding.severity)) &&
+      'message' in finding &&
+      typeof finding.message === 'string'
+  );
+}
+
 const result = await run(
   `Review this code for correctness issues:
 
@@ -49,6 +74,7 @@ function getDisplayName(user) {
           },
         },
         required: ['summary', 'findings'],
+        additionalProperties: false,
       },
     },
   }
@@ -62,12 +88,9 @@ if (!result.success) {
   throw new Error(`run() failed (${result.subtype}): ${detail}`);
 }
 
-// A successful run can still omit structured output, for example when the
-// model answers in prose instead of the requested schema.
-if (!result.structuredOutput) {
-  throw new Error('run() succeeded but returned no structured output.');
+// The SDK returns `unknown`; validate it before reading fields.
+if (!isCodeReview(result.structuredOutput)) {
+  throw new Error('run() returned an unexpected structured output shape.');
 }
 
-const review = result.structuredOutput as CodeReview;
-
-console.log(JSON.stringify(review, null, 2));
+console.log(JSON.stringify(result.structuredOutput, null, 2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@factory/droid-sdk",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "private": false,
   "description": "TypeScript SDK for the Factory Droid CLI",
   "keywords": [