deepspace 0.10.1 → 0.10.3

package/dist/server.js

@@ -611,6 +611,275 @@ function createDeepSpaceAI(env, provider, options = {}) {
   }
 }
 
+// src/server/utils/agent.ts
+import {
+  stepCountIs,
+  streamText
+} from "ai";
+
+// src/shared/ai-models.ts
+var MULTI_STEP_AGENT_PROFILES = ["application", "documentation"];
+function createMultiStepModelFactory(provider) {
+  return (model) => ({
+    ...model,
+    ...provider,
+    agentSupport: "multi-step",
+    agentProfiles: MULTI_STEP_AGENT_PROFILES
+  });
+}
+var anthropicModel = createMultiStepModelFactory({
+  provider: "anthropic",
+  providerLabel: "Anthropic",
+  transport: "messages"
+});
+var openAIModel = createMultiStepModelFactory({
+  provider: "openai",
+  providerLabel: "OpenAI",
+  transport: "chat-completions"
+});
+var DEEPSPACE_AI_MODELS = [
+  anthropicModel({
+    id: "claude-fable-5",
+    label: "Claude Fable 5",
+    family: "Claude 5",
+    recommendation: "frontier"
+  }),
+  anthropicModel({
+    id: "claude-opus-5",
+    label: "Claude Opus 5",
+    family: "Claude 5",
+    recommendation: "frontier"
+  }),
+  anthropicModel({
+    id: "claude-sonnet-5",
+    label: "Claude Sonnet 5",
+    family: "Claude 5",
+    recommendation: "balanced"
+  }),
+  anthropicModel({
+    id: "claude-haiku-4-5",
+    label: "Claude Haiku 4.5",
+    family: "Claude 4.5",
+    recommendation: "fast"
+  }),
+  openAIModel({
+    id: "gpt-5.6-sol",
+    label: "GPT-5.6 Sol",
+    family: "GPT-5.6",
+    recommendation: "frontier"
+  }),
+  openAIModel({
+    id: "gpt-5.6-terra",
+    label: "GPT-5.6 Terra",
+    family: "GPT-5.6",
+    recommendation: "balanced"
+  }),
+  openAIModel({
+    id: "gpt-5.6-luna",
+    label: "GPT-5.6 Luna",
+    family: "GPT-5.6",
+    recommendation: "fast"
+  }),
+  {
+    id: "gpt-oss-120b",
+    label: "GPT-OSS 120B",
+    provider: "cerebras",
+    providerLabel: "Cerebras",
+    family: "GPT-OSS",
+    agentSupport: "single-step",
+    agentProfiles: [],
+    transport: "chat-completions",
+    recommendation: "limited",
+    note: "Available for direct generation; the current proxy adapter has not passed multi-step tool-result continuation."
+  }
+];
+var DEEPSPACE_AI_DEFAULTS = {
+  agent: "claude-sonnet-5",
+  directGeneration: "claude-sonnet-5",
+  summarization: "claude-haiku-4-5"
+};
+var DEEPSPACE_AGENT_PROFILES = {
+  application: {
+    id: "application",
+    defaultModel: DEEPSPACE_AI_DEFAULTS.agent,
+    maxSteps: 21,
+    maxToolCalls: 20,
+    allowedTools: "application-defined"
+  },
+  documentation: {
+    id: "documentation",
+    defaultModel: DEEPSPACE_AI_DEFAULTS.agent,
+    // Permit up to twenty completed read-only tools plus one final synthesis
+    // step. The runner disables tools once the tool-call budget is exhausted.
+    maxSteps: 21,
+    maxToolCalls: 20,
+    allowedTools: ["documentation_search", "documentation_read"]
+  }
+};
+function getDeepSpaceAIModel(modelId) {
+  if (typeof modelId !== "string") return null;
+  return DEEPSPACE_AI_MODELS.find((model) => model.id === modelId) ?? null;
+}
+function resolveDeepSpaceAgentModel(modelId, profileId = "application") {
+  const profile = DEEPSPACE_AGENT_PROFILES[profileId];
+  const resolvedId = modelId === void 0 ? profile.defaultModel : modelId;
+  const model = getDeepSpaceAIModel(resolvedId);
+  if (!model || !model.agentProfiles.includes(profileId)) return null;
+  return { modelId: model.id, provider: model.provider, model, profile };
+}
+
+// src/server/utils/agent.ts
+var DeepSpaceAgentModelError = class extends Error {
+  constructor(modelId, profile) {
+    super(
+      `Model ${typeof modelId === "string" ? JSON.stringify(modelId) : String(modelId)} is not compatible with the ${profile} agent profile`
+    );
+    this.modelId = modelId;
+    this.profile = profile;
+    this.name = "DeepSpaceAgentModelError";
+  }
+  code = "unsupported_agent_model";
+};
+var DeepSpaceAgentProfileError = class extends Error {
+  constructor(profile, toolName) {
+    super(`The ${profile} agent profile does not allow tool ${JSON.stringify(toolName)}`);
+    this.profile = profile;
+    this.toolName = toolName;
+    this.name = "DeepSpaceAgentProfileError";
+  }
+  code = "agent_profile_violation";
+};
+function streamDeepSpaceAgent(env, options) {
+  const { profile, modelId, authToken, ...streamOptions } = options;
+  const selection = resolveDeepSpaceAgentModel(modelId, profile);
+  if (!selection) throw new DeepSpaceAgentModelError(modelId, profile);
+  if (selection.profile.allowedTools !== "application-defined") {
+    const allowed = selection.profile.allowedTools;
+    for (const toolName of Object.keys(streamOptions.tools ?? {})) {
+      if (!allowed.includes(toolName)) {
+        throw new DeepSpaceAgentProfileError(profile, toolName);
+      }
+    }
+  }
+  const provider = createDeepSpaceAI(env, selection.provider, authToken ? { authToken } : {});
+  const { prepareStep, tools, ...remainingStreamOptions } = streamOptions;
+  const boundedTools = limitToolExecutions(tools, selection.profile.maxToolCalls);
+  const result = streamText({
+    ...remainingStreamOptions,
+    ...boundedTools ? { tools: boundedTools } : {},
+    model: provider(selection.modelId),
+    stopWhen: stepCountIs(selection.profile.maxSteps),
+    prepareStep: enforceToolCallLimit(prepareStep, selection.profile.maxToolCalls),
+    ...selection.provider === "openai" ? { providerOptions: { openai: { reasoningEffort: "none" } } } : {}
+  });
+  return { selection, result };
+}
+function enforceToolCallLimit(prepareStep, maxToolCalls) {
+  if (maxToolCalls === void 0) return prepareStep;
+  return async (context) => {
+    const prepared = await prepareStep?.(context);
+    const completedToolCalls = context.steps.reduce(
+      (count, step) => count + step.toolCalls.length,
+      0
+    );
+    if (completedToolCalls < maxToolCalls) return prepared;
+    return { ...prepared, activeTools: [], toolChoice: "none" };
+  };
+}
+function limitToolExecutions(tools, maxToolCalls) {
+  if (!tools || maxToolCalls === void 0) return tools;
+  let executions = 0;
+  return Object.fromEntries(
+    Object.entries(tools).map(([name, definition]) => {
+      if (typeof definition.execute !== "function") return [name, definition];
+      const execute = definition.execute;
+      return [
+        name,
+        {
+          ...definition,
+          execute: (...args) => {
+            if (executions >= maxToolCalls) {
+              return Promise.resolve({
+                error: `The agent tool-call limit of ${maxToolCalls} has been reached`
+              });
+            }
+            executions++;
+            return execute(...args);
+          }
+        }
+      ];
+    })
+  );
+}
+function deepSpaceAgentErrorSummary(error, context = {}) {
+  const details = [];
+  const contextFields = [
+    context.profile ? `profile=${context.profile}` : void 0,
+    context.provider ? `provider=${safeLogToken(context.provider)}` : void 0,
+    context.modelId ? `model=${safeLogToken(context.modelId)}` : void 0
+  ].filter((part) => Boolean(part));
+  if (contextFields.length > 0) details.push(contextFields.join(" "));
+  const pending = [error];
+  const visited = /* @__PURE__ */ new Set();
+  while (pending.length > 0 && details.length < 8) {
+    const current = pending.shift();
+    if (current == null || visited.has(current)) continue;
+    visited.add(current);
+    if (typeof current === "object") {
+      const record = current;
+      const parts = [
+        typeof record.name === "string" ? `name=${safeLogToken(record.name)}` : current instanceof Error ? `name=${safeLogToken(current.name)}` : void 0,
+        safeErrorMessage(current, record),
+        typeof record.statusCode === "number" ? `status=${record.statusCode}` : void 0,
+        typeof record.code === "string" ? `code=${safeLogToken(record.code)}` : void 0,
+        typeof record.requestId === "string" ? `requestId=${safeLogToken(record.requestId)}` : void 0,
+        ...safeProviderResponseMetadata(record.responseBody)
+      ].filter((part) => Boolean(part));
+      details.push(parts.join(" ") || Object.prototype.toString.call(current));
+      if (record.lastError != null) pending.push(record.lastError);
+      if (record.cause != null) pending.push(record.cause);
+      if (Array.isArray(record.errors)) pending.push(...record.errors);
+      continue;
+    }
+    details.push(String(current));
+  }
+  return details.join(" <- ") || "Unknown error";
+}
+function safeErrorMessage(current, record) {
+  if (record.responseBody !== void 0) return void 0;
+  const message = current instanceof Error ? current.message : record.message;
+  if (typeof message !== "string" || !message.trim()) return void 0;
+  return `message=${safeLogText(message)}`;
+}
+function safeProviderResponseMetadata(responseBody) {
+  if (typeof responseBody !== "string") return [];
+  try {
+    const parsed = JSON.parse(responseBody);
+    const error = parsed.error && typeof parsed.error === "object" ? parsed.error : void 0;
+    const code = typeof error?.code === "string" ? error.code : typeof error?.type === "string" ? error.type : void 0;
+    const requestId = typeof parsed.request_id === "string" ? parsed.request_id : void 0;
+    return [
+      code ? `upstreamCode=${safeLogToken(code)}` : void 0,
+      requestId ? `upstreamRequestId=${safeLogToken(requestId)}` : void 0
+    ].filter((part) => Boolean(part));
+  } catch {
+    return [];
+  }
+}
+function safeLogToken(value) {
+  return value.replace(/[^a-zA-Z0-9._:/-]/g, "_").slice(0, 120);
+}
+function safeLogText(value) {
+  const withoutControlCharacters = Array.from(value, (character) => {
+    const codePoint = character.codePointAt(0) ?? 0;
+    return codePoint <= 31 || codePoint === 127 ? " " : character;
+  }).join("");
+  return withoutControlCharacters.replace(/\bBearer\s+[A-Za-z0-9._~+/=-]+/gi, "Bearer [redacted]").replace(
+    /\b(api[_ -]?key|authorization|password|secret|token)\b\s*[:=]\s*\S+/gi,
+    "$1=[redacted]"
+  ).trim().slice(0, 300);
+}
+
 // src/server/utils/composio-tools.ts
 import { tool, jsonSchema } from "ai";
 var EMPTY_SCHEMA = { type: "object", properties: {} };
@@ -5994,7 +6263,8 @@ var ALLOWED_BINDING_TYPES = /* @__PURE__ */ new Set([
   "queue",
   "browser_rendering",
   "analytics_engine",
-  "hyperdrive"
+  "hyperdrive",
+  "ratelimit"
 ]);
 var RESERVED_BINDING_NAMES = /* @__PURE__ */ new Set([
   "ASSETS",
@@ -6002,6 +6272,7 @@ var RESERVED_BINDING_NAMES = /* @__PURE__ */ new Set([
   "API_WORKER",
   "DEEPSPACE_APP_ID",
   "DEEPSPACE_RESOURCE_ID",
+  "DEEPSPACE_RELEASE_OPERATION_ID",
   "APP_NAME",
   "OWNER_USER_ID",
   "AUTH_JWT_PUBLIC_KEY",
@@ -6092,6 +6363,17 @@ function requiredFieldError(b) {
         return `hyperdrive binding "${b.name}": auto-provisioning not yet supported (provide a real id)`;
       }
       return null;
+    case "ratelimit":
+      if (!/^\d+$/u.test(b.namespace_id) || Number(b.namespace_id) <= 0) {
+        return `ratelimit binding "${b.name}" requires a positive integer namespace_id string`;
+      }
+      if (!Number.isInteger(b.simple?.limit) || b.simple.limit <= 0) {
+        return `ratelimit binding "${b.name}" requires simple.limit (positive integer)`;
+      }
+      if (b.simple.period !== 10 && b.simple.period !== 60) {
+        return `ratelimit binding "${b.name}" requires simple.period (10 or 60)`;
+      }
+      return null;
     case "ai":
     case "browser_rendering":
     case "analytics_engine":
@@ -6169,6 +6451,15 @@ function bindingManifestFromOutputConfig(outputConfig) {
     const id = pluckString(h, "id");
     if (name && id) out.push({ type: "hyperdrive", name, id });
   }
+  for (const r of asObjectArray(outputConfig.ratelimits)) {
+    const name = pluckString(r, "name");
+    const namespace_id = pluckString(r, "namespace_id");
+    const simple = isObject(r.simple) ? r.simple : null;
+    const limit = pluckNumber(simple, "limit");
+    const period = pluckNumber(simple, "period");
+    if (!name || !namespace_id || limit === null || period !== 10 && period !== 60) continue;
+    out.push({ type: "ratelimit", name, namespace_id, simple: { limit, period } });
+  }
   return out;
 }
 function isObject(v) {
@@ -7365,6 +7656,8 @@ export {
   DEFAULT_QUERY_LIMIT,
   DEPLOYED_APPS_DEFAULTS,
   DIRECTORY_SCHEMAS,
+  DeepSpaceAgentModelError,
+  DeepSpaceAgentProfileError,
   GLOBAL_DO_TYPES,
   GLOBAL_DO_TYPE_NAMES,
   GameRoom,
@@ -7424,6 +7717,7 @@ export {
   createScopedR2Handler,
   dataToColumnValues,
   decodeJwtPayload,
+  deepSpaceAgentErrorSummary,
   deleteChatCascade,
   deleteRecord,
   enqueueJob,
@@ -7481,6 +7775,7 @@ export {
   rowToData,
   runMigrations,
   saveYjsDoc,
+  streamDeepSpaceAgent,
   timingSafeEqualHex,
   timingSafeEqualStrings,
   totalChars,