deepccc 0.2.22 → 0.2.23

package/dist/decision-session.d.ts

@@ -41,6 +41,12 @@ export interface DecisionMetrics {
     contextChars: number;
 }
 export type DecisionFailureStatus = "timed_out" | "cancelled" | "invalid_output" | "step_limit" | "tool_error" | "context_limit" | "error";
+export interface DecisionDiagnostic {
+    /** Fixed categories only: no provider messages, input values or credentials. */
+    code: "provider_error" | "tool_input_invalid" | "unknown_tool" | "schema_validation_failed" | "protocol_error" | "output_truncated" | "incomplete_response" | "deadline_exceeded" | "cancelled" | "budget_exceeded" | "tool_execution_failed" | "internal_error";
+    stage: "provider" | "validation" | "protocol" | "runtime" | "tool";
+    httpStatus?: number;
+}
 export type DecisionResult<T> = {
     requestId: string;
     stateVersion: string | number;
@@ -51,6 +57,7 @@ export type DecisionResult<T> = {
 } | {
     status: DecisionFailureStatus;
     message: string;
+    diagnostic: DecisionDiagnostic;
 });
 /** Reusable model client; decisions do not share mutable history or invoke context compaction. */
 export declare class DecisionSession<T> {

package/dist/decision-session.js

@@ -6,11 +6,30 @@ import { performance } from "node:perf_hooks";
 import { config, normalizeDeepCccProvider } from "./config.js";
 class DecisionFailure extends Error {
     status;
-    constructor(status, message) {
+    diagnostic;
+    constructor(status, message, diagnostic) {
         super(message);
         this.status = status;
+        this.diagnostic = diagnostic;
     }
 }
+function failureDiagnostic(status, error) {
+    if (status === "timed_out")
+        return { code: "deadline_exceeded", stage: "runtime" };
+    if (status === "cancelled")
+        return { code: "cancelled", stage: "runtime" };
+    if (error instanceof DecisionFailure && error.diagnostic)
+        return error.diagnostic;
+    if (status === "context_limit" || status === "step_limit")
+        return { code: "budget_exceeded", stage: "runtime" };
+    if (status === "tool_error")
+        return { code: "tool_execution_failed", stage: "tool" };
+    return { code: status === "invalid_output" ? "protocol_error" : "internal_error", stage: "runtime" };
+}
+function providerDiagnostic(error) {
+    const status = error && typeof error === "object" && "statusCode" in error ? error.statusCode : undefined;
+    return { code: "provider_error", stage: "provider", ...(typeof status === "number" && Number.isInteger(status) && status >= 100 && status <= 599 ? { httpStatus: status } : {}) };
+}
 const SUBMIT = "submit_result";
 const DEADLINE = Symbol("decision deadline");
 function positive(value, fallback, name) {
@@ -133,7 +152,7 @@ export class DecisionSession {
             const status = signal.aborted ? signal.reason === DEADLINE ? "timed_out" : "cancelled"
                 : performance.now() >= deadline ? "timed_out" : error instanceof DecisionFailure ? error.status : "error";
             // Never echo provider errors, credentials, tool payloads or partially generated output.
-            outcome = { status, message: error instanceof DecisionFailure ? error.message : "Decision did not complete successfully" };
+            outcome = { status, message: error instanceof DecisionFailure ? error.message : "Decision did not complete successfully", diagnostic: failureDiagnostic(status, error) };
         }
         finally {
             clearTimeout(timer);
@@ -155,7 +174,7 @@ export class DecisionSession {
             if (!calls.length || ids.size !== calls.length)
                 throw new DecisionFailure("invalid_output", "Expected unique structured tool calls");
             if (calls.some(c => c.toolName !== SUBMIT && !Object.hasOwn(this.tools, c.toolName))) {
-                throw new DecisionFailure("invalid_output", "Tool is not allowed");
+                throw new DecisionFailure("invalid_output", "Tool is not allowed", { code: "unknown_tool", stage: "protocol" });
             }
             if (calls.some(c => c.toolName === SUBMIT)) {
                 if (calls.length !== 1)
@@ -163,7 +182,7 @@ export class DecisionSession {
                 const validated = await abortable(Promise.resolve().then(() => this.output.validate(calls[0].input)), signal);
                 check();
                 if (!validated.success)
-                    throw new DecisionFailure("invalid_output", "Result validation failed");
+                    throw new DecisionFailure("invalid_output", "Result validation failed", { code: "schema_validation_failed", stage: "validation" });
                 return validated.value;
             }
             if (step + 1 >= this.limits.steps)
@@ -178,7 +197,7 @@ export class DecisionSession {
                 const validated = await abortable(Promise.resolve().then(() => asSchema(definition.inputSchema).validate(call.input)), signal);
                 check();
                 if (!validated.success)
-                    throw new DecisionFailure("invalid_output", "Tool input validation failed");
+                    throw new DecisionFailure("invalid_output", "Tool input validation failed", { code: "tool_input_invalid", stage: "validation" });
                 inputs.push(validated.value);
             }
             messages.push({ role: "assistant", content: calls.map(c => ({ type: "tool-call", ...c })) });
@@ -211,10 +230,13 @@ export class DecisionSession {
         metrics.modelCalls++;
         const result = streamText({ model: this.model, system: this.system, messages: [...messages], tools: this.modelTools,
             toolChoice: "required", maxRetries: 0, abortSignal: signal, maxOutputTokens: this.maxOutputTokens,
+            // The SDK default logs raw errors. Return allowlisted diagnostics instead.
+            onError: () => { },
             ...(this.providerOptions ? { providerOptions: this.providerOptions } : {}) });
         const iterator = result.fullStream[Symbol.asyncIterator]();
         const calls = [];
         let finish;
+        let invalidCall;
         let chars = 0;
         try {
             while (true) {
@@ -223,14 +245,20 @@ export class DecisionSession {
                 if (next.done)
                     break;
                 const part = next.value;
-                if (part.type === "error" || part.type === "tool-error")
-                    throw new DecisionFailure("invalid_output", "Provider returned an invalid response");
+                if (part.type === "error")
+                    throw new DecisionFailure("invalid_output", "Provider request failed", providerDiagnostic(part.error));
+                if (part.type === "tool-error")
+                    invalidCall ??= { code: "tool_input_invalid", stage: "validation" };
                 if (part.type === "finish")
                     finish = part.finishReason;
                 if (part.type === "text-delta" || part.type === "reasoning-delta" || part.type === "tool-input-delta") {
                     chars += part.type === "tool-input-delta" ? part.delta.length : part.text.length;
                 }
                 if (part.type === "tool-call") {
+                    if ("invalid" in part && part.invalid) {
+                        invalidCall = { code: Object.hasOwn(this.modelTools, part.toolName) ? "tool_input_invalid" : "unknown_tool", stage: "validation" };
+                        continue;
+                    }
                     chars += boundedJson(part.input, this.limits.response).length;
                     calls.push({ toolCallId: part.toolCallId, toolName: part.toolName, input: part.input });
                 }
@@ -238,7 +266,9 @@ export class DecisionSession {
                     throw new DecisionFailure("invalid_output", "Response budget exceeded");
             }
             if (finish !== "stop" && finish !== "tool-calls")
-                throw new DecisionFailure("invalid_output", "Provider did not finish normally");
+                throw new DecisionFailure("invalid_output", "Provider did not finish normally", { code: finish === "length" ? "output_truncated" : "incomplete_response", stage: "protocol" });
+            if (invalidCall)
+                throw new DecisionFailure("invalid_output", "Invalid structured tool call", invalidCall);
             return calls;
         }
         finally {

package/dist/index.d.ts

@@ -6,7 +6,7 @@
 import { type DeepCccProvider } from "./config.js";
 import { type PermissionMode, type PermissionResolver } from "./permissions.js";
 export { DecisionSession } from "./decision-session.js";
-export type { DecisionModelConfig, DecisionSessionOptions, DecisionRequest, DecisionResult, DecisionMetrics, DecisionFailureStatus, DecisionTool, DecisionToolContext } from "./decision-session.js";
+export type { DecisionModelConfig, DecisionSessionOptions, DecisionRequest, DecisionResult, DecisionMetrics, DecisionFailureStatus, DecisionDiagnostic, DecisionTool, DecisionToolContext } from "./decision-session.js";
 export declare const DEFAULT_COMPACTION_TIMEOUT_MS: number;
 /**
  * 各操作系统特有的命令行指引（文本资产，维护在 os-prompts/ 目录，而非硬编码）：

package/docs/decision-session.md

@@ -150,6 +150,16 @@ and tool call counts, and the last assembled context size. Provider/tool error
 payloads and partial generated content are not copied into result messages.
 Invalid configuration/request budgets throw before contacting the provider.
 
+Since 0.2.23, failures also include a safe `diagnostic` object with a fixed `code`
+and `stage`. Categories distinguish provider errors, invalid tool input, result
+schema failures, truncated output, interrupted output, deadlines and cancellation.
+Provider HTTP status is included when available, but error messages, raw tool
+arguments, prompts, headers and response bodies are never copied into diagnostics.
+The SDK's default raw error logging is disabled for this API. Integrations can
+record their own schema issue paths inside their validators; keep values and raw
+payloads out of those records. The original `status` remains the control-flow
+contract. Diagnostics do not relax validation or trigger automatic retries.
+
 Pass an optional `AbortSignal` as the second argument to `decide()`. Provider SDK
 automatic retries are disabled; any future application retry needs a fresh,
 explicit budget. Non-cooperative asynchronous tools/streams are raced against

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepccc",
-  "version": "0.2.22",
+  "version": "0.2.23",
   "description": "A lightweight coding agent with OpenAI-compatible and Anthropic Messages API support.",
   "license": "Apache-2.0",
   "keywords": [