@hai.ai/jacs 0.6.0 → 0.8.0

package/src/a2a.js

@@ -332,7 +332,7 @@ class JACSA2AIntegration {
       wrapped.jacsParentSignatures = parentSignatures;
     }
 
-    return jacs.signRequest(wrapped);
+    return jacs.legacySignRequest(wrapped);
   }
 
   /**
@@ -449,7 +449,7 @@ class JACSA2AIntegration {
     }
 
     try {
-      const isValid = jacs.verifyResponse(wrappedArtifact);
+      const isValid = jacs.legacyVerifyResponse(wrappedArtifact);
       const signatureInfo = wrappedArtifact.jacsSignature || {};
 
       const result = {

package/testing.d.ts

@@ -0,0 +1,39 @@
+/**
+ * JACS Test Helpers
+ *
+ * Utilities for creating ephemeral clients in tests. Each client gets its own
+ * in-memory agent -- no config files, no key files, no env vars needed.
+ *
+ * @example
+ * ```typescript
+ * import { createTestClient, createTestClientSync } from '@hai.ai/jacs/testing';
+ *
+ * // Async (preferred)
+ * const client = await createTestClient('ring-Ed25519');
+ * const signed = await client.signMessage({ hello: 'test' });
+ * const result = await client.verify(signed.raw);
+ * assert(result.valid);
+ *
+ * // Sync
+ * const client2 = createTestClientSync('ring-Ed25519');
+ * const signed2 = client2.signMessageSync({ hello: 'test' });
+ * const result2 = client2.verifySync(signed2.raw);
+ * assert(result2.valid);
+ * ```
+ */
+import { JacsClient } from './client';
+export { JacsClient };
+/**
+ * Create an ephemeral JacsClient for testing (async). No files or env vars needed.
+ *
+ * @param algorithm - Signing algorithm (default: "ring-Ed25519" for speed)
+ * @returns A fully-initialized JacsClient backed by an in-memory agent
+ */
+export declare function createTestClient(algorithm?: string): Promise<JacsClient>;
+/**
+ * Create an ephemeral JacsClient for testing (sync). No files or env vars needed.
+ *
+ * @param algorithm - Signing algorithm (default: "ring-Ed25519" for speed)
+ * @returns A fully-initialized JacsClient backed by an in-memory agent
+ */
+export declare function createTestClientSync(algorithm?: string): JacsClient;

package/testing.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * JACS Test Helpers
+ *
+ * Utilities for creating ephemeral clients in tests. Each client gets its own
+ * in-memory agent -- no config files, no key files, no env vars needed.
+ *
+ * @example
+ * ```typescript
+ * import { createTestClient, createTestClientSync } from '@hai.ai/jacs/testing';
+ *
+ * // Async (preferred)
+ * const client = await createTestClient('ring-Ed25519');
+ * const signed = await client.signMessage({ hello: 'test' });
+ * const result = await client.verify(signed.raw);
+ * assert(result.valid);
+ *
+ * // Sync
+ * const client2 = createTestClientSync('ring-Ed25519');
+ * const signed2 = client2.signMessageSync({ hello: 'test' });
+ * const result2 = client2.verifySync(signed2.raw);
+ * assert(result2.valid);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JacsClient = void 0;
+exports.createTestClient = createTestClient;
+exports.createTestClientSync = createTestClientSync;
+const client_1 = require("./client");
+Object.defineProperty(exports, "JacsClient", { enumerable: true, get: function () { return client_1.JacsClient; } });
+/**
+ * Create an ephemeral JacsClient for testing (async). No files or env vars needed.
+ *
+ * @param algorithm - Signing algorithm (default: "ring-Ed25519" for speed)
+ * @returns A fully-initialized JacsClient backed by an in-memory agent
+ */
+async function createTestClient(algorithm) {
+    return client_1.JacsClient.ephemeral(algorithm ?? 'ring-Ed25519');
+}
+/**
+ * Create an ephemeral JacsClient for testing (sync). No files or env vars needed.
+ *
+ * @param algorithm - Signing algorithm (default: "ring-Ed25519" for speed)
+ * @returns A fully-initialized JacsClient backed by an in-memory agent
+ */
+function createTestClientSync(algorithm) {
+    return client_1.JacsClient.ephemeralSync(algorithm ?? 'ring-Ed25519');
+}
+//# sourceMappingURL=testing.js.map

package/vercel-ai.d.ts

@@ -0,0 +1,54 @@
+/**
+ * JACS Vercel AI SDK Adapter
+ *
+ * Provides cryptographic provenance signing for AI model outputs
+ * using the Vercel AI SDK's LanguageModelV3Middleware pattern.
+ *
+ * @example
+ * ```typescript
+ * import { JacsClient } from '@hai.ai/jacs/client';
+ * import { withProvenance } from '@hai.ai/jacs/vercel-ai';
+ * import { openai } from '@ai-sdk/openai';
+ * import { generateText } from 'ai';
+ *
+ * const client = await JacsClient.quickstart();
+ * const model = withProvenance(openai('gpt-4'), { client });
+ *
+ * const { text, providerMetadata } = await generateText({
+ *   model,
+ *   prompt: 'Hello!',
+ * });
+ *
+ * console.log(providerMetadata?.jacs?.documentId);
+ * ```
+ */
+import type { JacsClient } from './client.js';
+interface LanguageModelV3Middleware {
+    specificationVersion: 'v3';
+    transformParams?: (opts: any) => Promise<any>;
+    wrapGenerate?: (opts: any) => Promise<any>;
+    wrapStream?: (opts: any) => Promise<any>;
+}
+export interface ProvenanceOptions {
+    /** An initialized JacsClient instance. */
+    client: JacsClient;
+    /** Sign generated text output. Default: true. */
+    signText?: boolean;
+    /** Sign tool call results. Default: true. */
+    signToolResults?: boolean;
+    /** Throw on signing failure instead of logging. Default: false. */
+    strict?: boolean;
+    /** Additional metadata to include in provenance records. */
+    metadata?: Record<string, unknown>;
+}
+export interface ProvenanceRecord {
+    signed: boolean;
+    documentId: string;
+    agentId: string;
+    timestamp: string;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare function jacsProvenance(options: ProvenanceOptions): LanguageModelV3Middleware;
+export declare function withProvenance(model: any, options: ProvenanceOptions): any;
+export {};

package/vercel-ai.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * JACS Vercel AI SDK Adapter
+ *
+ * Provides cryptographic provenance signing for AI model outputs
+ * using the Vercel AI SDK's LanguageModelV3Middleware pattern.
+ *
+ * @example
+ * ```typescript
+ * import { JacsClient } from '@hai.ai/jacs/client';
+ * import { withProvenance } from '@hai.ai/jacs/vercel-ai';
+ * import { openai } from '@ai-sdk/openai';
+ * import { generateText } from 'ai';
+ *
+ * const client = await JacsClient.quickstart();
+ * const model = withProvenance(openai('gpt-4'), { client });
+ *
+ * const { text, providerMetadata } = await generateText({
+ *   model,
+ *   prompt: 'Hello!',
+ * });
+ *
+ * console.log(providerMetadata?.jacs?.documentId);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jacsProvenance = jacsProvenance;
+exports.withProvenance = withProvenance;
+// =============================================================================
+// Helpers
+// =============================================================================
+async function signContent(client, content, opts) {
+    try {
+        const signed = await client.signMessage(opts.metadata
+            ? { content, provenance: opts.metadata }
+            : content);
+        return {
+            signed: true,
+            documentId: signed.documentId,
+            agentId: signed.agentId,
+            timestamp: signed.timestamp,
+            metadata: opts.metadata,
+        };
+    }
+    catch (err) {
+        if (opts.strict) {
+            throw err;
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        console.error('[jacs/vercel-ai] signing failed:', message);
+        return {
+            signed: false,
+            documentId: '',
+            agentId: '',
+            timestamp: '',
+            error: message,
+            metadata: opts.metadata,
+        };
+    }
+}
+function extractTextFromContent(content) {
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .filter((part) => part.type === 'text')
+        .map((part) => part.text)
+        .join('');
+}
+// =============================================================================
+// jacsProvenance — returns a LanguageModelV3Middleware
+// =============================================================================
+function jacsProvenance(options) {
+    const signText = options.signText !== false;
+    const signToolResults = options.signToolResults !== false;
+    const middleware = {
+        specificationVersion: 'v3',
+        wrapGenerate: async ({ doGenerate, params }) => {
+            const result = await doGenerate();
+            if (!signText && !signToolResults) {
+                return result;
+            }
+            const provenance = {};
+            // Sign text content
+            if (signText) {
+                const text = extractTextFromContent(result.content);
+                if (text) {
+                    provenance.text = await signContent(options.client, text, options);
+                }
+            }
+            // Sign tool results if present in params prompt
+            if (signToolResults && params.prompt) {
+                const toolResults = params.prompt.filter((part) => part.role === 'tool');
+                if (toolResults.length > 0) {
+                    const toolData = toolResults.map((tr) => ({
+                        role: tr.role,
+                        content: tr.content,
+                    }));
+                    provenance.toolResults = await signContent(options.client, toolData, options);
+                }
+            }
+            // Attach provenance to provider metadata
+            return {
+                ...result,
+                providerMetadata: {
+                    ...result.providerMetadata,
+                    jacs: provenance,
+                },
+            };
+        },
+        wrapStream: async ({ doStream, params }) => {
+            const streamResult = await doStream();
+            if (!signText) {
+                return streamResult;
+            }
+            // Accumulate text chunks, sign on stream completion
+            let accumulatedText = '';
+            const originalStream = streamResult.stream;
+            const transform = new TransformStream({
+                transform(chunk, controller) {
+                    if (chunk.type === 'text-delta') {
+                        accumulatedText += chunk.textDelta;
+                    }
+                    controller.enqueue(chunk);
+                },
+                async flush(controller) {
+                    if (accumulatedText) {
+                        const provenance = await signContent(options.client, accumulatedText, options);
+                        controller.enqueue({
+                            type: 'provider-metadata',
+                            providerMetadata: {
+                                jacs: { text: provenance },
+                            },
+                        });
+                    }
+                },
+            });
+            return {
+                ...streamResult,
+                stream: originalStream.pipeThrough(transform),
+            };
+        },
+    };
+    return middleware;
+}
+// =============================================================================
+// withProvenance — convenience wrapper
+// =============================================================================
+function withProvenance(model, options) {
+    // Lazy import of wrapLanguageModel from 'ai'
+    let wrapLanguageModel;
+    try {
+        wrapLanguageModel = require('ai').wrapLanguageModel;
+    }
+    catch {
+        throw new Error("Could not import 'ai' package. Install it as a dependency: npm install ai");
+    }
+    return wrapLanguageModel({
+        model,
+        middleware: jacsProvenance(options),
+    });
+}
+//# sourceMappingURL=vercel-ai.js.map

package/vercel-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.js","sourceRoot":"","sources":["vercel-ai.ts"],"names":[],"mappings":"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"}