@hraness/sponge 0.4.1 → 0.5.1

package/dist/src/models/runtime.d.ts

@@ -1,5 +1,6 @@
 import type { AsrRuntime } from '../inference/asr/runtime.js';
 import type { EmbeddingRuntime } from '../inference/embedding/index.js';
+import type { MediaRuntime } from '../media/capture.js';
 import { type NativeCatalog, type NativeKind } from './catalog.js';
 export declare function nativeSetupPlan(kind: NativeKind, version: string): Promise<{
     supported: boolean;
@@ -11,12 +12,19 @@ export declare function nativeSetupPlan(kind: NativeKind, version: string): Prom
     requiredFreeBytes: number;
     artifacts: readonly import("./artifacts.js").ModelArtifact[];
 }>;
+type NativeRuntime = AsrRuntime | EmbeddingRuntime | MediaRuntime;
 export declare function setupNativeRuntime(cacheRoot: string, catalog: NativeCatalog, kind: NativeKind, options?: {
     signal?: AbortSignal;
-}): Promise<AsrRuntime | EmbeddingRuntime>;
+}): Promise<NativeRuntime>;
 export declare function provisionNative(kind: 'asr', cacheRoot: string, version: string, signal?: AbortSignal): Promise<AsrRuntime>;
 export declare function provisionNative(kind: 'embedding', cacheRoot: string, version: string, signal?: AbortSignal): Promise<EmbeddingRuntime>;
-export declare function provisionNative(kind: NativeKind, cacheRoot: string, version: string, signal?: AbortSignal): Promise<AsrRuntime | EmbeddingRuntime>;
+export declare function provisionNative(kind: 'media', cacheRoot: string, version: string, signal?: AbortSignal): Promise<MediaRuntime>;
+export declare function provisionNative(kind: NativeKind, cacheRoot: string, version: string, signal?: AbortSignal): Promise<NativeRuntime>;
 export declare function inspectNative(kind: 'asr', cacheRoot: string, version: string): Promise<AsrRuntime>;
 export declare function inspectNative(kind: 'embedding', cacheRoot: string, version: string): Promise<EmbeddingRuntime>;
-export declare function inspectNative(kind: NativeKind, cacheRoot: string, version: string): Promise<AsrRuntime | EmbeddingRuntime>;
+export declare function inspectNative(kind: 'media', cacheRoot: string, version: string): Promise<MediaRuntime>;
+export declare function inspectNative(kind: NativeKind, cacheRoot: string, version: string): Promise<NativeRuntime>;
+type RuntimeOf<K extends NativeKind> = K extends 'asr' ? AsrRuntime : K extends 'embedding' ? EmbeddingRuntime : MediaRuntime;
+/** An installed runtime, or undefined when it is not installed or this platform cannot run it. */
+export declare function optionalNative<K extends NativeKind>(kind: K, cacheRoot: string, version: string): Promise<RuntimeOf<K> | undefined>;
+export {};

package/dist/src/models/runtime.js

@@ -4,7 +4,7 @@ import { privateRoot } from '../acquisition/files.js';
 import { nativeArtifactFetch } from './download.js';
 import { inspectInstalledModelPackage, provisionModelPackage, recoverModelPackage, modelSetupPlan, } from './artifacts.js';
 import { nativePlatformSupported, nativeModelPackage, loadNativeCatalog, } from './catalog.js';
-import { SpongeError } from '../errors.js';
+import { SpongeError, publicCode } from '../errors.js';
 export async function nativeSetupPlan(kind, version) {
     const catalog = await loadNativeCatalog(version);
     return {
@@ -24,6 +24,10 @@ function asr(c, p) {
         model: p['whistle.cact'],
     };
 }
+function media(c, p) {
+    return { helper: p['sponge-media'], helperSha256: c.artifacts.find((a) => a.role === 'media-helper').sha256 };
+}
+const runtimeOf = (kind, c, p) => kind === 'asr' ? asr(c, p) : kind === 'embedding' ? embedding(c, p) : media(c, p);
 function embedding(c, p) {
     return {
         helper: p['sponge-embedding'],
@@ -48,7 +52,7 @@ export async function setupNativeRuntime(cacheRoot, catalog, kind, options = {})
     await privateRoot(cacheRoot);
     await recoverModelPackage(cacheRoot, manifest);
     const paths = await provisionModelPackage(cacheRoot, manifest, { ...options, fetch: nativeArtifactFetch(manifest) });
-    return kind === 'asr' ? asr(catalog, paths) : embedding(catalog, paths);
+    return runtimeOf(kind, catalog, paths);
 }
 async function installed(cacheRoot, catalog, kind) {
     const paths = await inspectInstalledModelPackage(cacheRoot, nativeModelPackage(catalog, kind));
@@ -56,18 +60,21 @@ async function installed(cacheRoot, catalog, kind) {
         throw new SpongeError('runtime-missing');
     return paths;
 }
-async function inspectAsrRuntime(cacheRoot, catalog) {
-    supported();
-    return asr(catalog, await installed(cacheRoot, catalog, 'asr'));
-}
-async function inspectEmbeddingRuntime(cacheRoot, catalog) {
-    supported();
-    return embedding(catalog, await installed(cacheRoot, catalog, 'embedding'));
-}
 export async function provisionNative(kind, cacheRoot, version, signal) {
     return setupNativeRuntime(cacheRoot, await loadNativeCatalog(version), kind, { signal });
 }
 export async function inspectNative(kind, cacheRoot, version) {
+    supported();
     const catalog = await loadNativeCatalog(version);
-    return kind === 'asr' ? inspectAsrRuntime(cacheRoot, catalog) : inspectEmbeddingRuntime(cacheRoot, catalog);
+    return runtimeOf(kind, catalog, await installed(cacheRoot, catalog, kind));
+}
+/** An installed runtime, or undefined when it is not installed or this platform cannot run it. */
+export async function optionalNative(kind, cacheRoot, version) {
+    try {
+        return (await inspectNative(kind, cacheRoot, version));
+    }
+    catch (error) {
+        if (!['runtime-missing', 'unsupported'].includes(publicCode(error, 'integrity')))
+            throw error;
+    }
 }

package/dist/src/pdf/capture-helper.js

@@ -1,10 +1,11 @@
-// Pinned public SDK bridge. Native subprocesses inherit the supervisor's group.
+// Pinned public Wordcell bridge. Native subprocesses inherit the supervisor's group.
 const runtime = process.argv[2], args = process.argv.slice(3);
 try {
-    const { runPdfAcquisition } = await import(import.meta.resolve('@hraness/ghostget/pdf-acquisition', `${runtime}/package.json`));
-    const { runPdfToolCommand } = await import(import.meta.resolve('@hraness/wordcell/pdf', `${runtime}/package.json`));
-    process.exitCode = await runPdfAcquisition(args, process.env, { stdout: (value) => process.stdout.write(value), stderr: (value) => process.stderr.write(value) }, {
-        runTool: (specification) => runPdfToolCommand({ ...specification, processGroup: 'inherit' }),
+    const { runPdfCommand, runPdfToolCommand } = await import(import.meta.resolve('@hraness/wordcell/pdf', `${runtime}/package.json`));
+    process.exitCode = await runPdfCommand(args, process.env, { stdout: (value) => process.stdout.write(value), stderr: (value) => process.stderr.write(value) }, {
+        captureDependencies: {
+            runTool: (specification) => runPdfToolCommand({ ...specification, processGroup: 'inherit' }),
+        },
     });
 }
 catch {

package/dist/src/pdf/capture.d.ts

@@ -2,10 +2,6 @@ import type { CaptureResult, ErrorEnvelope } from '../../contracts/index.js';
 import { runOwned } from '../acquisition/process.js';
 import { type CaptureRuntime } from '../acquisition/runtime.js';
 type CaptureConnection = {
-    kind: 'account';
-    stateHome: string;
-    accountId: string;
-} | {
     kind: 'cdp';
     endpoint: string;
 };

package/dist/src/pdf/capture.js

@@ -52,7 +52,7 @@ export async function capturePdf(request) {
         return failure(requestId, 'invalid-input');
     if (url.protocol === 'file:' && (url.host || url.search || url.hash || request.connection))
         return failure(requestId, 'invalid-input');
-    if (request.connection?.kind === 'cdp' || request.allowPrivateNetwork)
+    if (request.connection || request.allowPrivateNetwork)
         return failure(requestId, 'unsupported');
     const captureHelper = fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? './capture-helper.ts' : './capture-helper.js', import.meta.url));
     const args = [
@@ -76,21 +76,9 @@ export async function capturePdf(request) {
         '--quiet',
         '--json',
     ];
-    let selectedState;
-    if (request.connection?.kind === 'account') {
-        if (!/^[a-zA-Z0-9_.-]{1,128}$/.test(request.connection.accountId))
-            return failure(requestId, 'invalid-input');
-        try {
-            selectedState = await privateRoot(request.connection.stateHome);
-        }
-        catch {
-            return failure(requestId, 'repair-auth');
-        }
-        args.push('--auth', request.connection.accountId);
-    }
     const root = await realpath(await mkdtemp(join(base, 'capture-'))), home = join(root, 'home'), output = join(root, 'bundles');
     args.push('--output', output);
-    const env = isolatedEnvironment(home, home, selectedState ?? join(home, 'state'));
+    const env = isolatedEnvironment(home, home);
     const controller = new AbortController();
     const abort = () => controller.abort();
     signal?.addEventListener('abort', abort, { once: true });

package/dist/src/pdf/errors.js

@@ -1,4 +1,4 @@
-import { failure, upstreamFailure } from '../acquisition/errors.js';
+import { failure } from '../acquisition/errors.js';
 /** Wordcell's pinned PDF code field is authoritative; prose is never classified. */
 export function pdfFailure(value, requestId) {
     if (!value || typeof value !== 'object' || Array.isArray(value))
@@ -6,8 +6,6 @@ export function pdfFailure(value, requestId) {
     const record = value;
     if (record.ok !== false)
         return failure(requestId, 'unclassified');
-    if (record.captureError)
-        return upstreamFailure(value, requestId);
     const codes = {
         'invalid-input': 'invalid-input',
         encrypted: 'unsupported',

package/dist/src/worker/basic.d.ts

@@ -2,7 +2,7 @@ import type { LibraryStore } from '../store/index.js';
 import { type ArticleOptions, type ArticleOutcome } from '../app/article.js';
 import { type MediaOptions } from '../media/handler.js';
 /** Content handlers over the durable sequential worker and its process supervisor. */
-export declare function drainLibrary(store: LibraryStore, options: ArticleOptions & Pick<MediaOptions, 'asrRuntime' | 'language' | 'forceLocal'> & {
+export declare function drainLibrary(store: LibraryStore, options: ArticleOptions & Pick<MediaOptions, 'asrRuntime' | 'mediaRuntime' | 'language' | 'forceLocal'> & {
     jobId?: string;
     resolveConnection?: (realm: string) => ArticleOptions['connection'];
     onResult?: (result: ArticleOutcome) => void;

package/dist/src/worker/basic.js

@@ -1,4 +1,5 @@
 import { failure } from '../acquisition/errors.js';
+import { codeOf, publicCode } from '../errors.js';
 import { ingestArticle } from '../app/article.js';
 import { ingestPdf } from '../pdf/index.js';
 import { ingestMedia } from '../media/handler.js';
@@ -11,10 +12,11 @@ export async function drainLibrary(store, options) {
         try {
             connection = options.resolveConnection?.(source?.realm ?? 'public') ?? options.connection;
         }
-        catch {
-            store.queue.fail(context.attempt, 'repair-auth');
+        catch (error) {
+            const code = codeOf(error) === 'connection-retired' ? 'connection-retired' : 'repair-auth';
+            store.queue.fail(context.attempt, code);
             store.queue.settle(context.attempt);
-            return { ...failure(context.attempt.attemptId, 'repair-auth', 'acquisition'), cleanup: 'settled' };
+            return { ...failure(context.attempt.attemptId, publicCode(code), 'acquisition'), cleanup: 'settled' };
         }
         if (source?.kind === 'media') {
             const { capture: _articleCapture, ...mediaOptions } = options;

package/native/runtime-manifest.json

@@ -20,21 +20,29 @@
       "sha256": "9526db9ee35e7eb4a5a58ac1e53330032f22a13890bd4ee01818fb380a57a362"
     },
     {
-      "bytes": 23486,
+      "bytes": 534912,
+      "name": "sponge-media-macos26-arm64",
+      "role": "media-helper",
+      "sha256": "c4ce953a360fda573004ad69407a29f212e12564bf191cefaa2f8c05fec852ce"
+    },
+    {
+      "bytes": 23606,
       "name": "native-NOTICES.txt",
       "role": "notices",
-      "sha256": "6e62f14bd094001b8da42af6fc42877e51b0d5616ae960917ef214fc45767088"
+      "sha256": "f56e55503bebba456ce7a8bcc4bcab3a5c34fa71d57c1e0243179dd4ba429fbf"
     }
   ],
   "build": {
-    "asrSourceSha256": "6a84b1b2040f17cb510a71548c1453442df15f820ceb0ac8cec3086b4ccefbdc",
+    "asrSourceSha256": "6d060d06c7efdc2a9a5537b4d2e108673afc0db596367e9ff876af44bc60d942",
     "clangVersion": "Apple clang version 21.0.0 (clang-2100.1.1.101)",
-    "embeddingSourceSha256": "b029dadccaeba029fb9ef302daaefc6a134e8d46440c1e8c227f374d97202ce3",
+    "embeddingSourceSha256": "04e07c5f696d5d1d639b004c200da0d0044e473a8b6fdc6ef2be696a97fdf552",
+    "mediaSourceSha256": "b35bba5fb8d9f88d67a0aa6fc3e282bd9dbed9077d994fc4de4428eb3df6381e",
+    "rustcVersion": "rustc 1.97.1 (8bab26f4f 2026-07-14)",
     "swiftVersion": "Apple Swift version 6.3.3 (swiftlang-6.3.3.1.3 clang-2100.1.1.101)"
   },
   "minimumMacOS": "26.0",
-  "packageVersion": "0.4.1",
+  "packageVersion": "0.5.1",
   "platform": "darwin",
   "schemaVersion": 1,
-  "sourceCommit": "82fefa4ca18700e2e7390e1372c7c672ddac11fa"
+  "sourceCommit": "142391ee43de6dc6dba8ef209c73b177539b4725"
 }

package/package.json

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

package/dist/src/media/capture-helper.js

@@ -1,21 +0,0 @@
-/** Public Ghostget SDK bridge; its complete inherited group belongs to the caller. */
-import { readFile } from 'node:fs/promises';
-import { processIdentity } from '../worker/identity.js';
-import { SpongeError } from '../errors.js';
-try {
-    const config = JSON.parse(await readFile(process.argv[2], 'utf8'));
-    const sdk = await import(import.meta.resolve('@hraness/ghostget/media-acquisition', `${config.runtimeRoot}/package.json`));
-    const identity = await processIdentity(process.pid);
-    if (!identity)
-        throw new SpongeError('unavailable');
-    const result = await sdk.acquireEphemeralMedia({
-        ...config.request,
-        processGroup: 'inherit',
-        supervisor: { requestId: config.requestId, processGroupId: process.pid, processStartIdentity: identity.started },
-    });
-    process.stdout.write(JSON.stringify(result));
-}
-catch {
-    process.stdout.write(JSON.stringify({ ok: false, code: 'unavailable', cleanup: 'settled' }));
-    process.exitCode = 1;
-}