@deepstrike/sdk 0.1.5 → 0.1.8

package/dist/runtime/server.js

@@ -0,0 +1,37 @@
+const BROWSER_LIKE_GLOBALS = ["window", "document", "navigator", "self"];
+/**
+ * Some server-side tools install browser globals into Node for DOM work. SDKs
+ * that probe those globals during construction can then misclassify the host as
+ * a browser, so hide them only for the synchronous server-only bootstrap and
+ * restore the process exactly as we found it afterward.
+ */
+export function withServerRuntimeGuard(fn) {
+    const snapshots = BROWSER_LIKE_GLOBALS.map(name => ({
+        name,
+        descriptor: Object.getOwnPropertyDescriptor(globalThis, name),
+    }));
+    try {
+        for (const { name, descriptor } of snapshots) {
+            if (!descriptor)
+                continue;
+            if (descriptor.configurable) {
+                Reflect.deleteProperty(globalThis, name);
+            }
+            else if ("value" in descriptor && descriptor.writable) {
+                Object.defineProperty(globalThis, name, { ...descriptor, value: undefined });
+            }
+        }
+        return fn();
+    }
+    finally {
+        for (const { name, descriptor } of snapshots) {
+            restoreGlobal(name, descriptor);
+        }
+    }
+}
+function restoreGlobal(name, descriptor) {
+    if (descriptor)
+        Object.defineProperty(globalThis, name, descriptor);
+    else
+        Reflect.deleteProperty(globalThis, name);
+}

package/dist/safety/permissions.d.ts

@@ -24,6 +24,7 @@ export declare class PermissionManager {
         requiresApproval?: boolean;
         note?: string;
     }): this;
+    grantWithApproval(resource: string, action: string, note?: string): this;
     revoke(resource: string, action: string, note?: string): this;
     private matchPermission;
     evaluate(resource: string, action: string): PermissionDecision;

package/dist/safety/permissions.js

@@ -19,6 +19,9 @@ export class PermissionManager {
         });
         return this;
     }
+    grantWithApproval(resource, action, note = "") {
+        return this.grant(resource, action, { requiresApproval: true, note });
+    }
     revoke(resource, action, note = "") {
         const key = `${resource}:${action}`;
         this.permissions.set(key, { tool: resource, action, allowed: false, requiresApproval: false, note });

package/dist/signals/gateway.js

@@ -33,6 +33,10 @@ export class SignalGateway {
             this.timers.delete(key);
             this.emit({
                 kind: "scheduled",
+                source: "cron",
+                signalType: "job",
+                urgency: "normal",
+                dedupeKey: key,
                 payload: { goal: prompt.goal, criteria: prompt.criteria, runAtMs: prompt.runAtMs, ...prompt.metadata },
             });
         };

package/dist/signals/scheduled.js

@@ -12,6 +12,10 @@ export class ScheduledPrompt {
     toSignal() {
         return {
             kind: "scheduled",
+            source: "cron",
+            signalType: "job",
+            urgency: "normal",
+            dedupeKey: `cron:${this.goal}:${this.runAtMs}`,
             payload: { goal: this.goal, criteria: this.criteria, runAtMs: this.runAtMs, ...this.metadata },
         };
     }

package/dist/signals/types.d.ts

@@ -1,6 +1,15 @@
+export type RuntimeSignalSource = "cron" | "gateway" | "heartbeat" | "custom";
+export type RuntimeSignalType = "event" | "job" | "alert";
+export type RuntimeSignalUrgency = "low" | "normal" | "high" | "critical";
 export interface RuntimeSignal {
-    kind: "interrupt" | "scheduled" | "external";
+    source: RuntimeSignalSource;
+    signalType: RuntimeSignalType;
+    urgency: RuntimeSignalUrgency;
     payload: Record<string, unknown>;
+    dedupeKey?: string;
+    /** @deprecated Use source/signalType/urgency directly. */
+    kind?: "interrupt" | "scheduled" | "external";
+    /** @deprecated Prefer explicit `urgency`. */
     priority?: number;
 }
 export interface SignalSource {

package/dist/types.d.ts

@@ -20,7 +20,13 @@ export interface AudioPart {
     /** MIME type, e.g. `"audio/wav"`. */
     mediaType: string;
 }
-export type ContentPart = TextPart | ImagePart | AudioPart;
+export interface ToolResultPart {
+    type: "tool_result";
+    callId: string;
+    output: string;
+    isError: boolean;
+}
+export type ContentPart = TextPart | ImagePart | AudioPart | ToolResultPart;
 export interface Message {
     role: "system" | "user" | "assistant" | "tool";
     /** Plain-text content. When `contentParts` is present, this holds only the text segments. */
@@ -103,7 +109,16 @@ export interface RetryConfig {
     circuitOpenAfter?: number;
     circuitResetAfter?: number;
 }
+/**
+ * Opaque provider-owned state scoped to a single Agent run.
+ *
+ * The framework only creates and threads this object through provider turns.
+ * Providers may use it for protocol-native continuation state such as
+ * Responses `previous_response_id` without leaking those semantics into the kernel.
+ */
+export type ProviderRunState = Record<string, unknown>;
 export interface LLMProvider {
+    createRunState?(): ProviderRunState;
     complete(messages: Message[], tools: ToolSchema[]): Promise<Message>;
-    stream(messages: Message[], tools: ToolSchema[], extensions?: Record<string, unknown>): AsyncIterable<StreamEvent>;
+    stream(messages: Message[], tools: ToolSchema[], extensions?: Record<string, unknown>, state?: ProviderRunState): AsyncIterable<StreamEvent>;
 }

package/package.json

@@ -1,18 +1,23 @@
 {
   "name": "@deepstrike/sdk",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "description": "DeepStrike Node.js SDK",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
-    "test": "node --experimental-vm-modules node_modules/.bin/jest"
+    "test": "node --experimental-vm-modules node_modules/.bin/jest",
+    "smoke:providers": "node ../scripts/smoke-node-provider-loops.mjs"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.39.0",
-    "@deepstrike/core": "0.1.5",
+    "@deepstrike/core": "0.1.8",
+    "@google/generative-ai": "^0.24.1",
     "openai": "^4.77.0"
   },
   "devDependencies": {