@hraness/sponge 0.3.2 → 0.3.4

package/dist/src/cli/main.js

@@ -8,7 +8,7 @@ import { command, usageOf } from './commands.js';
 import { openLibrary } from '../store/index.js';
 import { defaultCapturePins } from '../acquisition/index.js';
 import { failure } from '../acquisition/errors.js';
-import { SpongeError, codeOf, publicCode, exitFor, hints, debugChain } from '../errors.js';
+import { SpongeError, codeOf, publicCode, exitFor, hints, detailHints, debugChain, } from '../errors.js';
 /** Failures print one categorical JSON line: the public code, its specific `reason` when narrower, and a fixed hint.
  * Causes, details, paths and upstream messages appear only with --debug or SPONGE_DEBUG=1. */
 function report(error, requestId, debug) {
@@ -17,7 +17,7 @@ function report(error, requestId, debug) {
         process.stderr.write(JSON.stringify({ issues }) + '\n');
     const hint = code === 'invalid-input' && typeof usage === 'string' && command(usage)
         ? `Usage: ${usageOf(usage).replace(/\n/g, ' | ')}`
-        : hints[code];
+        : (detailHints[reason] ?? hints[code]);
     process.stderr.write(JSON.stringify({ ...failure(requestId, code), ...(reason !== code ? { reason } : {}), hint }) + '\n');
     if (debug)
         process.stderr.write(debugChain(error));

package/dist/src/digest/endpoint.js

@@ -116,7 +116,7 @@ async function complete(origin, request, model, messages, schema, o) {
     });
     if (!response.ok) {
         await response.body?.cancel().catch(() => undefined);
-        throw new SpongeError('unavailable');
+        throw new SpongeError('model-unavailable', { detail: { status: response.status } });
     }
     let parsed;
     try {
@@ -125,14 +125,14 @@ async function complete(origin, request, model, messages, schema, o) {
     catch (error) {
         if (error instanceof SpongeError)
             throw error;
-        throw new SpongeError('unavailable');
+        throw new SpongeError('model-unavailable');
     }
     const choice = parsed?.choices?.[0];
     if (choice?.finish_reason === 'length')
         throw new SpongeError('limit-exceeded');
     const content = choice?.message?.content;
     if (typeof content !== 'string' || !content.trim())
-        throw new SpongeError('unavailable');
+        throw new SpongeError('model-unavailable');
     if (Buffer.byteLength(content) > o.maxOutputBytes)
         throw new SpongeError('limit-exceeded');
     return content;

package/dist/src/digest/pipeline.js

@@ -486,7 +486,7 @@ export async function draftDigest(input) {
                 throw new SpongeError('limit-exceeded');
             if (error instanceof SpongeError)
                 throw error;
-            throw new SpongeError('unavailable');
+            throw new SpongeError('model-unavailable', { cause: error });
         }
         if (userSignal.aborted)
             throw new SpongeError('cancelled');
@@ -610,7 +610,7 @@ export async function draftDigest(input) {
         result = await attempt(await call([...messages, { role: 'assistant', content: first }, { role: 'user', content: repairPrompt(result.issues) }], schema));
     }
     if (!result.draft)
-        throw new SpongeError('unavailable', { issues: result.issues });
+        throw new SpongeError('draft-rejected', { issues: result.issues });
     let issues = result.issues;
     if (issues.length) {
         trace.dropped = prune(result.draft, issues, source, options);
@@ -618,7 +618,7 @@ export async function draftDigest(input) {
         if (result.draft.digest.ideas.length < L.minIdeas)
             issues = [...issues.filter((i) => !(i.path === 'ideas' && i.code === 'count')), { path: 'ideas', code: 'count' }];
         if (issues.length)
-            throw new SpongeError('unavailable', { issues });
+            throw new SpongeError('draft-rejected', { issues });
     }
     const producer = {
         pipeline: 'sponge-digest',

package/dist/src/errors.d.ts

@@ -16,6 +16,8 @@ declare const parents: {
     readonly 'not-digest': "unsupported";
     readonly malformed: "invalid-input";
     readonly 'no-capture': "invalid-input";
+    readonly 'draft-rejected': "unavailable";
+    readonly 'model-unavailable': "unavailable";
     readonly 'parent-missing': "invalid-input";
     readonly 'target-exists': "invalid-input";
 };
@@ -27,6 +29,8 @@ export declare const isSpongeCode: (value: unknown) => value is SpongeCode;
 export declare const exitStatus: Readonly<Record<ErrorCode, number>>;
 /** The one code→user-facing hint table. Fixed text only: never paths, sources, credentials or upstream prose. */
 export declare const hints: Readonly<Record<ErrorCode, string>>;
+/** Hints for detail codes whose public code's hint would mislead. Fixed text only, like `hints`. */
+export declare const detailHints: Readonly<Partial<Record<DetailCode, string>>>;
 export interface SpongeErrorOptions {
     detail?: Record<string, unknown>;
     cause?: unknown;

package/dist/src/errors.js

@@ -30,6 +30,8 @@ const parents = {
     'not-digest': 'unsupported',
     malformed: 'invalid-input',
     'no-capture': 'invalid-input',
+    'draft-rejected': 'unavailable',
+    'model-unavailable': 'unavailable',
     'parent-missing': 'invalid-input',
     'target-exists': 'invalid-input',
 };
@@ -77,6 +79,11 @@ export const hints = {
     'schema-newer': 'This library was written by a newer Sponge. Upgrade Sponge.',
     'owner-busy': 'Another Sponge process owns the library. Wait for it, or run `sponge queue recover` after it stops.',
 };
+/** Hints for detail codes whose public code's hint would mislead. Fixed text only, like `hints`. */
+export const detailHints = {
+    'draft-rejected': 'The model draft failed the digest checks listed above, even after one repair. Drafting is deterministic, so the same capture and model fail again; refresh the item or use another model.',
+    'model-unavailable': 'The model server did not answer or returned an error. Check that it is still running and has free GPU memory (another loaded model can exhaust it), then retry.',
+};
 /** The one error type. `message` is the code, so bare `String(error)` never carries detail, paths or causes. */
 export class SpongeError extends Error {
     code;

package/native/runtime-manifest.json

@@ -27,14 +27,14 @@
     }
   ],
   "build": {
-    "asrSourceSha256": "8bd77ebffabae786902304eacb983fc950f70c981fb1538696517d85052c9407",
+    "asrSourceSha256": "ca98fb111b0d2b26ca697a6c0d55d76f7d2b5b752bff8fc053ae19389d16a52c",
     "clangVersion": "Apple clang version 21.0.0 (clang-2100.1.1.101)",
-    "embeddingSourceSha256": "2b0cd2b9c52c9dee578a3be50a443d528d5204d47f3f9ba750f6a1f37a191e78",
+    "embeddingSourceSha256": "af6d6c01934d64427f2a9cb36f83edaea372f6bf2e522166b9e86e3b15f72784",
     "swiftVersion": "Apple Swift version 6.3.3 (swiftlang-6.3.3.1.3 clang-2100.1.1.101)"
   },
   "minimumMacOS": "26.0",
-  "packageVersion": "0.3.2",
+  "packageVersion": "0.3.4",
   "platform": "darwin",
   "schemaVersion": 1,
-  "sourceCommit": "e9eb0613365859c5809a05e8ad909504ac6e8d66"
+  "sourceCommit": "4e42216e86da07224ec81512c2efa0a710e38500"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hraness/sponge",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "A local library for captured articles and verified offline assets.",
   "repository": {
     "type": "git",