loopengine 0.1.54 → 0.1.56

package/dist/core/storage-signers/gcs.d.ts

@@ -0,0 +1,2 @@
+import type { SignRequest } from './types.js';
+export declare function signGcsUrl(req: SignRequest): Promise<string>;

package/dist/core/storage-signers/gcs.js

@@ -0,0 +1,43 @@
+// Extracted straight out of adapters/http.ts's own original
+// handleGcsRedirect, unchanged apart from returning the signed URL
+// instead of writing the HTTP response itself — see index.ts's own doc
+// comment for why signing lives here, one file per provider, instead of
+// inline in the route handler.
+export async function signGcsUrl(req) {
+    // Imported by a variable, not a string literal, so tsc treats this as
+    // Promise<any> instead of trying to resolve @google-cloud/storage's
+    // own types at compile time — installing it is only required at
+    // runtime for a deployment that actually uses this provider, not
+    // every loopengine install.
+    const gcsModuleName = '@google-cloud/storage';
+    let gcs;
+    try {
+        gcs = await import(gcsModuleName);
+    }
+    catch {
+        throw new Error('requires the @google-cloud/storage package — npm install @google-cloud/storage in your own project.');
+    }
+    let client;
+    const credentialsJson = process.env.GOOGLE_APPLICATION_CREDENTIALS_JSON;
+    if (credentialsJson) {
+        let credentials;
+        try {
+            credentials = JSON.parse(credentialsJson);
+        }
+        catch {
+            throw new Error('GOOGLE_APPLICATION_CREDENTIALS_JSON is not valid JSON — paste the entire contents of the downloaded service-account key file, unedited.');
+        }
+        client = new gcs.Storage({ credentials, projectId: credentials.project_id });
+    }
+    else {
+        client = new gcs.Storage();
+    }
+    const file = client.bucket(req.bucket).file(req.object);
+    const expires = Date.now() + 5 * 60 * 1000;
+    const signOptions = { action: 'read', expires };
+    if (req.disposition === 'attachment') {
+        signOptions.responseDisposition = `attachment; filename="${req.filename || req.object.split('/').pop()}"`;
+    }
+    const [signedUrl] = await file.getSignedUrl(signOptions);
+    return signedUrl;
+}

package/dist/core/storage-signers/index.d.ts

@@ -0,0 +1,2 @@
+import type { StorageSigner } from './types.js';
+export declare const storageSigners: Record<string, StorageSigner>;

package/dist/core/storage-signers/index.js

@@ -0,0 +1,4 @@
+import { signGcsUrl } from './gcs.js';
+export const storageSigners = {
+    gcs: signGcsUrl,
+};

package/dist/core/storage-signers/types.d.ts

@@ -0,0 +1,7 @@
+export interface SignRequest {
+    bucket: string;
+    object: string;
+    disposition?: 'inline' | 'attachment';
+    filename?: string;
+}
+export type StorageSigner = (req: SignRequest) => Promise<string>;

package/dist/core/storage-signers/types.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { runAgent } from '#core/run-agent.js';
+export { storageSigners } from '#core/storage-signers/index.js';
+export type { SignRequest, StorageSigner } from '#core/storage-signers/types.js';
 export type { Message, ModelCall, ModelContentBlock, ModelResponse, RunAgentOptions, RunAgentResult, } from '#core/run-agent.js';
 export type { AgentConfig, AgentModelConfig, ToolSchema, ToolDefinition } from '#core/agent-config.js';
 export type * from './core/loop-events.js';

package/dist/index.js

@@ -4,6 +4,7 @@
 // built on top of this surface, not part of it — see the README section
 // "Using loopengine as a library" for the boundary and why.
 export { runAgent } from '#core/run-agent.js';
+export { storageSigners } from '#core/storage-signers/index.js';
 // The framework-agnostic browser client for adapters/http.ts's own wire
 // protocol (see client.ts's own header comment) — this, not a deep
 // subpath import, is how a consumer's React/Vue/etc. chat UI is meant to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopengine",
-  "version": "0.1.54",
+  "version": "0.1.56",
   "type": "module",
   "description": "Runtime for tool-using AI agents with a transparent ReAct loop.",
   "license": "MIT",
@@ -29,6 +29,7 @@
     "dist/core/run-agent.d.ts",
     "dist/core/known-urls.js",
     "dist/core/known-urls.d.ts",
+    "dist/core/storage-signers",
     "dist/core/loop-events.js",
     "dist/core/loop-events.d.ts",
     "dist/core/client.js",