@struktoai/mirage-browser 0.0.2-alpha.0 → 0.0.3-alpha.0

package/README.md

@@ -23,135 +23,125 @@
         <img src="https://img.shields.io/npm/v/%40struktoai%2Fmirage-browser.svg?color=0C0C0C&labelColor=FAFAFA"/></a>
 </p>
 
-Mirage is **a Unified Virtual File System for AI Agents**: a single tree that mounts services and data sources like S3, Google Drive, Slack, Gmail, and Redis side-by-side as one filesystem.
+<p align="center">
+  <a href="https://github.com/strukto-ai/mirage#readme"><img alt="README in English" src="https://img.shields.io/badge/English-d9d9d9"></a>
+  <a href="https://github.com/strukto-ai/mirage/blob/main/readme/README.zh-CN.md"><img alt="简体中文 README" src="https://img.shields.io/badge/简体中文-d9d9d9"></a>
+  <a href="https://github.com/strukto-ai/mirage/blob/main/readme/README.zh-TW.md"><img alt="繁體中文 README" src="https://img.shields.io/badge/繁體中文-d9d9d9"></a>
+  <a href="https://github.com/strukto-ai/mirage/blob/main/readme/README.fr.md"><img alt="README en Français" src="https://img.shields.io/badge/Français-d9d9d9"></a>
+  <a href="https://github.com/strukto-ai/mirage/blob/main/readme/README.vi.md"><img alt="README Tiếng Việt" src="https://img.shields.io/badge/Ti%E1%BA%BFng%20Vi%E1%BB%87t-d9d9d9"></a>
+  <a href="https://github.com/strukto-ai/mirage/blob/main/readme/README.ko.md"><img alt="README 한국어" src="https://img.shields.io/badge/%ED%95%9C%EA%B5%AD%EC%96%B4-d9d9d9"></a>
+</p>
 
-AI agents reach every backend with the same handful of Unix-like tools, and pipelines compose across services as naturally as on a local disk. It's a simulated environment, agents see one filesystem underneath. Any LLM that already knows bash can use Mirage out of the box, with zero new vocabulary.
+Mirage is **a Unified Virtual File System for AI Agents**: it mounts services and data sources like S3, Google Drive, Slack, Gmail, and Redis side-by-side as one filesystem. Any LLM that already knows bash can read, grep, and pipe across every backend out of the box, with zero new vocabulary.
 
 ```ts
 const ws = new Workspace({
-  '/data': new RAMResource(),
-  '/s3': new S3Resource({ bucket: 'logs' }),
-  '/slack': new SlackResource({}),
-  '/github': new GitHubResource({}),
+  '/data':  new RAMResource(),
+  '/s3':    new S3Resource({ bucket: 'logs' }),
+  '/slack': new SlackResource({ token: process.env.SLACK_BOT_TOKEN! }),
 })
 
-await ws.execute('grep alert /slack/general/*.json | wc -l')
-await ws.execute('cat /github/mirage/README.md')
+await ws.execute('grep -r alert /slack/channels/general__C04QX/ | wc -l')
 await ws.execute('cp /s3/report.csv /data/local.csv')
+await ws.execute('wc -l $(find /s3/data -name "*.jsonl")')
+
+// Commands are extensible: register new commands, or override one per
+// resource + filetype, e.g. `cat` on S3 Parquet renders rows as JSON.
+ws.command('summarize', ...)
+ws.command('cat', { resource: 's3', filetype: 'parquet' }, ...)
+
+await ws.execute('summarize /data/local.csv')
+await ws.execute('cat /s3/events/2026-05-06.parquet | jq .user')
 ```
 
 ## About
 
-- **One filesystem, every backend.** Every service speaks the same filesystem semantics, so agents reason about one abstraction instead of N SDKs and M MCPs, leaning on the filesystem and bash vocabulary LLMs are most fluent in.
-- **Multiple resources, one filesystem:** RAM, Disk, Redis, S3 / R2 / OCI / Supabase / GCS, Gmail / GDrive / GDocs / GSheets / GSlides, GitHub / Linear / Notion / Trello, Slack / Discord / Telegram / Email, MongoDB, SSH, and more, mounted side-by-side under a single root.
-- **Familiar bash tools across every mount.** Agents reuse the same handful of Unix-like tools instead of learning a new API per service, and pipelines compose across services as naturally as on a local disk, the exact corpus modern LLMs are most heavily trained on.
-- **Portable workspaces:** clone, snapshot, and version your environment. Move agent runs between machines without restarting or reconfiguring the system.
-- **Embed in your apps and services:** Python and TypeScript SDKs let you give your AI agents a virtual filesystem directly inside FastAPI, Express, browser apps, or any async runtime, no separate process required. Clone, snapshot, and version the workspace from inside your code.
-- **Works with major agent application frameworks:** OpenAI Agents SDK, Vercel AI SDK (TypeScript), LangChain, Pydantic AI, CAMEL, and OpenHands.
-- **Lightweight CLI + daemon:** plugs into coding agents like Claude Code and Codex so they reach every mounted resource through familiar bash, getting more useful work done per turn.
+- **One interface instead of N SDKs and M MCPs.** Every service speaks the same filesystem semantics, and pipelines compose across services as naturally as on a local disk.
+- **Around 50 built-in backends:** RAM, Disk, Redis, S3 / R2 / OCI / Supabase / GCS, Gmail / GDrive / GDocs / GSheets / GSlides, GitHub / Linear / Notion / Trello, Slack / Discord / Telegram / Email, MongoDB / Postgres / LanceDB, SSH, and more, mounted side-by-side under a single root.
+- **Portable workspaces:** clone, snapshot, and version a workspace; agent runs move between machines without restarting or reconfiguring the system.
+- **Embeddable:** the Python and TypeScript SDKs run in-process inside FastAPI, Express, browser apps, or any async runtime; no separate process required.
+- **Agent integrations:** OpenAI Agents SDK, Vercel AI SDK, LangChain, Pydantic AI, CAMEL, and OpenHands via the SDKs; coding agents like Claude Code and Codex via the lightweight CLI + daemon.
 
 ## Architecture
 
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/strukto-ai/mirage/main/assets/mirage-arch-dark.svg">
-    <img src="https://raw.githubusercontent.com/strukto-ai/mirage/main/assets/mirage-arch-light.svg" alt="Mirage architecture: AI Agent and Application → Mirage Bash and VFS → Dispatcher &amp; Cache → Infrastructure and Remote" width="900">
+    <img src="https://raw.githubusercontent.com/strukto-ai/mirage/main/assets/mirage-arch-light.svg" alt="Mirage architecture: AI Agent and Application → Mirage Bash and VFS → Dispatcher &amp; Cache → Infrastructure and Remote" width="720">
   </picture>
 </p>
 
 ## Installation
 
-### Prerequisites
-
-- **Python** ≥ 3.12 for the `mirage-ai` package and the `mirage` CLI
+- **Python** ≥ 3.11 for the `mirage-ai` package and the `mirage` CLI
 - **Node.js** ≥ 20 for the TypeScript SDK
 - **macOS** or **Linux** (FUSE-based mounts require platform support)
 
 ### Python
 
 ```bash
-uv add mirage-ai
+uv add mirage-ai    # installs the `mirage` library and the `mirage` CLI binary
 ```
 
-This installs both the `mirage` library and the `mirage` CLI binary.
-
 ### TypeScript
 
-Pick the package that matches your runtime:
-
 ```bash
 npm install @struktoai/mirage-node      # Node.js servers and CLIs
 npm install @struktoai/mirage-browser   # browser / edge runtimes
-npm install @struktoai/mirage-core      # runtime-agnostic primitives
+npm install @struktoai/mirage-agents    # OpenAI / Vercel AI / LangChain / Mastra adapters
 ```
 
-`@struktoai/mirage-node` and `@struktoai/mirage-browser` both pull in `@struktoai/mirage-core` automatically.
+Both runtime packages pull in `@struktoai/mirage-core` automatically.
 
 ### CLI
 
 ```bash
 curl -fsSL https://strukto.ai/mirage/install.sh | sh
-```
-
-Or via your package manager of choice:
-
-```bash
+# or
 npm install -g @struktoai/mirage-cli
-```
-
-```bash
+# or
 uvx mirage-ai
-```
-
-```bash
+# or
 npx @struktoai/mirage-cli
 ```
 
-## Quickstart (Python)
+## Quickstart
+
+### Python
 
 ```python
 from mirage import Workspace
-from mirage.resource.gdocs import GDocsConfig, GDocsResource
 from mirage.resource.ram import RAMResource
 from mirage.resource.s3 import S3Config, S3Resource
-from mirage.resource.slack import SlackConfig, SlackResource
 
 ws = Workspace({
-    "/data":  RAMResource(),
-    "/s3":    S3Resource(S3Config(bucket="my-bucket")),
-    "/slack": SlackResource(SlackConfig()),
-    "/docs":  GDocsResource(GDocsConfig()),
+    "/data": RAMResource(),
+    "/s3":   S3Resource(S3Config(bucket="my-bucket")),
 })
 
 await ws.execute("cp /s3/report.csv /data/report.csv")
 await ws.execute("grep alert /s3/data/log.jsonl | wc -l")
 
-ws.snapshot("demo.tar")
+await ws.snapshot("demo.tar")
 ```
 
-## Quickstart (TypeScript)
+### TypeScript
 
 ```ts
-import {
-  Workspace,
-  RAMResource,
-  S3Resource,
-  SlackResource,
-  GDocsResource,
-} from '@struktoai/mirage-browser'
+import { Workspace, RAMResource, S3Resource } from '@struktoai/mirage-node'
 
 const ws = new Workspace({
   '/data': new RAMResource(),
   '/s3': new S3Resource({ bucket: 'my-bucket' }),
-  '/slack': new SlackResource({}),
-  '/docs': new GDocsResource({}),
 })
 
 await ws.execute('cp /s3/report.csv /data/report.csv')
 await ws.execute('grep alert /s3/data/log.jsonl | wc -l')
+
+await ws.snapshot('demo.tar')
 ```
 
-## Quickstart (CLI)
+### CLI
 
 ```bash
 mirage workspace create ws.yaml --id demo
@@ -163,89 +153,33 @@ mirage workspace load demo.tar --id demo-restored
 
 ## Agent Frameworks
 
-Mirage drops into the major agent application frameworks as a sandbox or tool layer. Your agent runs against the same mount tree it would in bash, so swapping the model or runtime never changes the surface.
-
-### OpenAI Agents SDK (Python)
+Mirage plugs into agent frameworks as a sandbox or tool layer. POSIX operations such as `read` can also be customized per resource and filetype, e.g. reading a PDF returns parsed pages instead of raw bytes.
 
-The `MirageSandboxClient` plugs a `Workspace` into the OpenAI Agents SDK as a sandbox: bash commands the agent runs execute against your mounts.
-
-```python
-from agents import Runner
-from agents.run import RunConfig
-from agents.sandbox import SandboxAgent, SandboxRunConfig
-
-from mirage.agents.openai_agents import MirageSandboxClient
-
-client = MirageSandboxClient(ws)
-agent = SandboxAgent(
-    name="Mirage Sandbox Agent",
-    model="gpt-5.4-nano",
-    instructions=ws.file_prompt,
-)
-
-result = await Runner.run(
-    agent,
-    "Summarize /s3/data/report.parquet into /report.txt.",
-    run_config=RunConfig(sandbox=SandboxRunConfig(client=client)),
-)
-```
-
-### Vercel AI SDK (TypeScript)
-
-`mirageTools(ws)` exposes the workspace as a typed AI SDK tool set, so any model wired into the AI SDK can read and write across mounts, in Node or the browser.
-
-```ts
-import { generateText } from 'ai'
-import { openai } from '@ai-sdk/openai'
-import { mirageTools } from '@struktoai/mirage-agents/vercel'
-import { buildSystemPrompt } from '@struktoai/mirage-agents/openai'
-
-const { text } = await generateText({
-  model: openai('gpt-5.4-nano'),
-  system: buildSystemPrompt({ mountInfo: { '/': 'In-memory filesystem' } }),
-  prompt: "Use readFile to read /docs/paper.pdf, then describe what's in it.",
-  tools: mirageTools(ws),
-})
-```
-
-LangChain, Pydantic AI, CAMEL, OpenHands, and Mastra adapters live alongside these.
+|               | Integrations                                                                                                                                                                                                                                                                                                                                                                                                               |
+| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Python        | [OpenAI Agents SDK](https://docs.mirage.strukto.ai/python/agents/openai-agents), [LangChain](https://docs.mirage.strukto.ai/python/agents/langchain), [Pydantic AI](https://docs.mirage.strukto.ai/python/agents/pydantic-ai), [CAMEL](https://docs.mirage.strukto.ai/python/agents/camel), [OpenHands](https://docs.mirage.strukto.ai/python/agents/openhands), [Agno](https://docs.mirage.strukto.ai/python/agents/agno) |
+| TypeScript    | [Vercel AI SDK](https://docs.mirage.strukto.ai/typescript/agents/vercel), [OpenAI Agents SDK](https://docs.mirage.strukto.ai/typescript/agents/openai), [LangChain](https://docs.mirage.strukto.ai/typescript/agents/langchain), [Mastra](https://docs.mirage.strukto.ai/typescript/agents/mastra)                                                                                                                         |
+| Coding agents | [Claude Code](https://docs.mirage.strukto.ai/python/agents/claude-code), [Codex](https://docs.mirage.strukto.ai/python/agents/codex), [OpenCode](https://docs.mirage.strukto.ai/typescript/agents/opencode), [Pi](https://docs.mirage.strukto.ai/typescript/agents/pi)                                                                                                                                                     |
 
 ## Cache
 
-Every `Workspace` ships with a **two-layer cache** so repeated work against remote backends (S3, GDrive, Slack, …) hits local state instead of the network:
+Every `Workspace` has a two-layer cache so repeated work against remote backends hits local state instead of the network:
 
-- **Index cache.** Listings and metadata. The first directory walk hits the API; subsequent ones serve from the index until TTL expires.
-- **File cache.** Object bytes. The first read streams from origin; later pipelines read from cache.
-- **Pluggable backends.** Each layer is a store with two built-ins:
-  - **RAM** (default): in-process, zero setup, 512 MB file cache and 10-minute index TTL. Best for single-process apps and notebooks.
-  - **Redis**: shared across workers, processes, and machines. Best for serverless, multi-replica services, or when you want cache state to survive restarts.
+- **Index cache:** listings and metadata. The first directory walk hits the API; later ones serve from the index until the TTL expires (default 10 minutes).
+- **File cache:** object bytes. The first read streams from origin; later pipelines read from cache (default 512 MB).
+
+Both layers default to in-process RAM with zero setup. A Redis store shares cache state across workers, processes, and machines:
 
 ```ts
-import { RedisFileCacheStore, RedisIndexCacheStore, Workspace } from 'mirage/node'
+import { RedisFileCacheStore, S3Resource, Workspace } from '@struktoai/mirage-node'
 
 const ws = new Workspace(
   { '/s3': new S3Resource({ bucket: 'my-bucket' }) },
   {
-    cache: new RedisFileCacheStore({ url: 'redis://localhost:6379/0', limit: '8GB' }),
-    index: new RedisIndexCacheStore({ url: 'redis://localhost:6379/0', ttl: 600 }),
+    cache: new RedisFileCacheStore({ url: 'redis://localhost:6379/0', cacheLimit: '8GB' }),
+    index: { type: 'redis', url: 'redis://localhost:6379/0', ttl: 600 },
   },
 )
 ```
 
-```ts
-import { S3Resource, Workspace } from 'mirage/node'
-
-const ws = new Workspace({ '/s3': new S3Resource({ bucket: 'my-bucket' }) })
-
-// 1. Index miss → S3 LIST. Listing stored in index cache.
-await ws.execute('ls /s3/data/')
-
-// 2. Index hit → 0 network calls.
-await ws.execute('find /s3/data/ -name "*.jsonl"')
-
-// 3. File miss → S3 GET. Bytes stored in file cache.
-await ws.execute('cat /s3/data/log.jsonl | wc -l')
-
-// 4. File hit → 0 network calls.
-await ws.execute('grep alert /s3/data/log.jsonl')
-```
+See the [cache docs](https://docs.mirage.strukto.ai/home/cache) for the full miss/hit lifecycle.

package/dist/aliyun-F2ORS3KZ.js

@@ -0,0 +1,8 @@
+import {
+  AliyunResource
+} from "./chunk-GHKX2BA3.js";
+import "./chunk-XFREXNA2.js";
+export {
+  AliyunResource
+};
+//# sourceMappingURL=aliyun-F2ORS3KZ.js.map

package/dist/backblaze-HOVWPSV7.js

@@ -0,0 +1,8 @@
+import {
+  BackblazeResource
+} from "./chunk-EUKHGXCE.js";
+import "./chunk-XFREXNA2.js";
+export {
+  BackblazeResource
+};
+//# sourceMappingURL=backblaze-HOVWPSV7.js.map

package/dist/box-VJSE5N7P.js

@@ -0,0 +1,8 @@
+import {
+  BoxResource
+} from "./chunk-D6HF462C.js";
+import "./chunk-J54OBIJA.js";
+export {
+  BoxResource
+};
+//# sourceMappingURL=box-VJSE5N7P.js.map

package/dist/ceph-CQKQ4NWW.js

@@ -0,0 +1,8 @@
+import {
+  CephResource
+} from "./chunk-RJ5FBBL6.js";
+import "./chunk-XFREXNA2.js";
+export {
+  CephResource
+};
+//# sourceMappingURL=ceph-CQKQ4NWW.js.map

package/dist/chunk-2H4KUUFP.js

@@ -0,0 +1,26 @@
+// src/resource/gdocs/config.ts
+import { normalizeFields, redactConfigWithSchema, secretStr, z } from "@struktoai/mirage-core";
+var GDocsConfigSchema = z.object({
+  clientId: z.string(),
+  clientSecret: secretStr().optional(),
+  refreshToken: secretStr()
+});
+function redactGDocsConfig(config) {
+  return redactConfigWithSchema(GDocsConfigSchema, config);
+}
+function normalizeGDocsConfig(input) {
+  return normalizeFields(input, {
+    rename: {
+      client_id: "clientId",
+      client_secret: "clientSecret",
+      refresh_token: "refreshToken"
+    }
+  });
+}
+
+export {
+  GDocsConfigSchema,
+  redactGDocsConfig,
+  normalizeGDocsConfig
+};
+//# sourceMappingURL=chunk-2H4KUUFP.js.map

package/dist/chunk-2H4KUUFP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resource/gdocs/config.ts"],"sourcesContent":["// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport { normalizeFields, redactConfigWithSchema, secretStr, z } from '@struktoai/mirage-core'\n\nexport interface GDocsConfig {\n  clientId: string\n  clientSecret?: string\n  refreshToken: string\n  refreshFn?: (refreshToken: string) => Promise<{ accessToken: string; expiresIn: number }>\n}\n\nexport interface GDocsConfigRedacted {\n  clientId: string\n  clientSecret?: '<REDACTED>'\n  refreshToken: '<REDACTED>'\n}\n\nexport const GDocsConfigSchema = z.object({\n  clientId: z.string(),\n  clientSecret: secretStr().optional(),\n  refreshToken: secretStr(),\n})\n\nexport function redactGDocsConfig(config: GDocsConfig): GDocsConfigRedacted {\n  return redactConfigWithSchema(GDocsConfigSchema, config) as unknown as GDocsConfigRedacted\n}\n\nexport function normalizeGDocsConfig(input: Record<string, unknown>): GDocsConfig {\n  return normalizeFields(input, {\n    rename: {\n      client_id: 'clientId',\n      client_secret: 'clientSecret',\n      refresh_token: 'refreshToken',\n    },\n  }) as unknown as GDocsConfig\n}\n"],"mappings":";AAcA,SAAS,iBAAiB,wBAAwB,WAAW,SAAS;AAe/D,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,UAAU,EAAE,OAAO;AAAA,EACnB,cAAc,UAAU,EAAE,SAAS;AAAA,EACnC,cAAc,UAAU;AAC1B,CAAC;AAEM,SAAS,kBAAkB,QAA0C;AAC1E,SAAO,uBAAuB,mBAAmB,MAAM;AACzD;AAEO,SAAS,qBAAqB,OAA6C;AAChF,SAAO,gBAAgB,OAAO;AAAA,IAC5B,QAAQ;AAAA,MACN,WAAW;AAAA,MACX,eAAe;AAAA,MACf,eAAe;AAAA,IACjB;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/chunk-32VC36P4.js

@@ -0,0 +1,89 @@
+import {
+  S3Resource
+} from "./chunk-XFREXNA2.js";
+
+// src/resource/qingstor/qingstor.ts
+import {
+  remapCommandsResource,
+  remapOpsResource,
+  ResourceName
+} from "@struktoai/mirage-core";
+
+// src/resource/qingstor/config.ts
+import { redactConfigWithSchema, secretSchema, z } from "@struktoai/mirage-core";
+var QingStorConfigSchema = z.object({
+  bucket: z.string(),
+  presignedUrlProvider: secretSchema(
+    z.custom((value) => typeof value === "function")
+  ),
+  region: z.string().optional(),
+  endpoint: z.string().optional(),
+  defaultContentType: z.string().optional()
+});
+function resolvedQingStorEndpoint(config) {
+  if (config.endpoint !== void 0 && config.endpoint !== "") return config.endpoint;
+  if (config.region !== void 0 && config.region !== "") {
+    const region = config.region;
+    return `https://s3.${region}.qingstor.com`;
+  }
+  return void 0;
+}
+function qingStorToS3Config(config) {
+  const endpoint = resolvedQingStorEndpoint(config);
+  return {
+    bucket: config.bucket,
+    presignedUrlProvider: config.presignedUrlProvider,
+    ...config.region !== void 0 ? { region: config.region } : {},
+    ...endpoint !== void 0 ? { endpoint } : {},
+    ...config.defaultContentType !== void 0 ? { defaultContentType: config.defaultContentType } : {}
+  };
+}
+function redactQingStorConfig(config) {
+  return redactConfigWithSchema(QingStorConfigSchema, config);
+}
+
+// src/resource/qingstor/prompt.ts
+var QINGSTOR_BROWSER_PROMPT = `{prefix}
+  Remote QingStor bucket (S3-compatible) accessed via presigned URLs (browser runtime).
+  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.
+  Listing operations require the presigner to sign LIST/COPY operations in
+  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.`;
+
+// src/resource/qingstor/qingstor.ts
+var QingStorResource = class extends S3Resource {
+  kind = ResourceName.QINGSTOR;
+  prompt = QINGSTOR_BROWSER_PROMPT;
+  qingStorConfig;
+  qingStorOps;
+  qingStorCommands;
+  constructor(config) {
+    super(qingStorToS3Config(config));
+    this.qingStorConfig = config;
+    this.qingStorOps = remapOpsResource(super.ops(), ResourceName.QINGSTOR);
+    this.qingStorCommands = remapCommandsResource(super.commands(), ResourceName.QINGSTOR);
+  }
+  ops() {
+    return this.qingStorOps;
+  }
+  commands() {
+    return this.qingStorCommands;
+  }
+  getState() {
+    return Promise.resolve({
+      type: this.kind,
+      config: redactQingStorConfig(this.qingStorConfig)
+    });
+  }
+  loadState(_state) {
+    return Promise.resolve();
+  }
+};
+
+export {
+  resolvedQingStorEndpoint,
+  qingStorToS3Config,
+  redactQingStorConfig,
+  QINGSTOR_BROWSER_PROMPT,
+  QingStorResource
+};
+//# sourceMappingURL=chunk-32VC36P4.js.map

package/dist/chunk-32VC36P4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resource/qingstor/qingstor.ts","../src/resource/qingstor/config.ts","../src/resource/qingstor/prompt.ts"],"sourcesContent":["// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport {\n  remapCommandsResource,\n  remapOpsResource,\n  ResourceName,\n  type RegisteredCommand,\n  type RegisteredOp,\n} from '@struktoai/mirage-core'\nimport { S3Resource } from '../s3/s3.ts'\nimport {\n  qingStorToS3Config,\n  redactQingStorConfig,\n  type QingStorConfig,\n  type QingStorConfigRedacted,\n} from './config.ts'\nimport { QINGSTOR_BROWSER_PROMPT } from './prompt.ts'\n\nexport interface QingStorResourceState {\n  type: string\n  config: QingStorConfigRedacted\n}\n\nexport class QingStorResource extends S3Resource {\n  override readonly kind: string = ResourceName.QINGSTOR\n  override readonly prompt: string = QINGSTOR_BROWSER_PROMPT\n  readonly qingStorConfig: QingStorConfig\n  private readonly qingStorOps: readonly RegisteredOp[]\n  private readonly qingStorCommands: readonly RegisteredCommand[]\n\n  constructor(config: QingStorConfig) {\n    super(qingStorToS3Config(config))\n    this.qingStorConfig = config\n    this.qingStorOps = remapOpsResource(super.ops(), ResourceName.QINGSTOR)\n    this.qingStorCommands = remapCommandsResource(super.commands(), ResourceName.QINGSTOR)\n  }\n\n  override ops(): readonly RegisteredOp[] {\n    return this.qingStorOps\n  }\n\n  override commands(): readonly RegisteredCommand[] {\n    return this.qingStorCommands\n  }\n\n  override getState(): Promise<QingStorResourceState> {\n    return Promise.resolve({\n      type: this.kind,\n      config: redactQingStorConfig(this.qingStorConfig),\n    })\n  }\n\n  override loadState(_state: QingStorResourceState): Promise<void> {\n    return Promise.resolve()\n  }\n}\n","// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport { redactConfigWithSchema, secretSchema, z } from '@struktoai/mirage-core'\nimport type { S3BrowserPresignedUrlProvider, S3Config } from '../s3/config.ts'\n\nexport interface QingStorConfig {\n  bucket: string\n  presignedUrlProvider: S3BrowserPresignedUrlProvider\n  region?: string\n  endpoint?: string\n  defaultContentType?: string\n}\n\nexport interface QingStorConfigRedacted extends Omit<QingStorConfig, 'presignedUrlProvider'> {\n  presignedUrlProvider: '<REDACTED>'\n}\n\nexport const QingStorConfigSchema = z.object({\n  bucket: z.string(),\n  presignedUrlProvider: secretSchema(\n    z.custom<S3BrowserPresignedUrlProvider>((value) => typeof value === 'function'),\n  ),\n  region: z.string().optional(),\n  endpoint: z.string().optional(),\n  defaultContentType: z.string().optional(),\n})\n\nexport function resolvedQingStorEndpoint(config: QingStorConfig): string | undefined {\n  if (config.endpoint !== undefined && config.endpoint !== '') return config.endpoint\n  if (config.region !== undefined && config.region !== '') {\n    const region = config.region\n    return `https://s3.${region}.qingstor.com`\n  }\n  return undefined\n}\n\nexport function qingStorToS3Config(config: QingStorConfig): S3Config {\n  const endpoint = resolvedQingStorEndpoint(config)\n  return {\n    bucket: config.bucket,\n    presignedUrlProvider: config.presignedUrlProvider,\n    ...(config.region !== undefined ? { region: config.region } : {}),\n    ...(endpoint !== undefined ? { endpoint } : {}),\n    ...(config.defaultContentType !== undefined\n      ? { defaultContentType: config.defaultContentType }\n      : {}),\n  }\n}\n\nexport function redactQingStorConfig(config: QingStorConfig): QingStorConfigRedacted {\n  return redactConfigWithSchema(QingStorConfigSchema, config) as unknown as QingStorConfigRedacted\n}\n","// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nexport const QINGSTOR_BROWSER_PROMPT = `{prefix}\n  Remote QingStor bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE — see S3BrowserPresignedUrlProvider docs.`\n"],"mappings":";;;;;AAcA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;;;ACNP,SAAS,wBAAwB,cAAc,SAAS;AAejD,IAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,QAAQ,EAAE,OAAO;AAAA,EACjB,sBAAsB;AAAA,IACpB,EAAE,OAAsC,CAAC,UAAU,OAAO,UAAU,UAAU;AAAA,EAChF;AAAA,EACA,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,oBAAoB,EAAE,OAAO,EAAE,SAAS;AAC1C,CAAC;AAEM,SAAS,yBAAyB,QAA4C;AACnF,MAAI,OAAO,aAAa,UAAa,OAAO,aAAa,GAAI,QAAO,OAAO;AAC3E,MAAI,OAAO,WAAW,UAAa,OAAO,WAAW,IAAI;AACvD,UAAM,SAAS,OAAO;AACtB,WAAO,cAAc,MAAM;AAAA,EAC7B;AACA,SAAO;AACT;AAEO,SAAS,mBAAmB,QAAkC;AACnE,QAAM,WAAW,yBAAyB,MAAM;AAChD,SAAO;AAAA,IACL,QAAQ,OAAO;AAAA,IACf,sBAAsB,OAAO;AAAA,IAC7B,GAAI,OAAO,WAAW,SAAY,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC;AAAA,IAC/D,GAAI,aAAa,SAAY,EAAE,SAAS,IAAI,CAAC;AAAA,IAC7C,GAAI,OAAO,uBAAuB,SAC9B,EAAE,oBAAoB,OAAO,mBAAmB,IAChD,CAAC;AAAA,EACP;AACF;AAEO,SAAS,qBAAqB,QAAgD;AACnF,SAAO,uBAAuB,sBAAsB,MAAM;AAC5D;;;ACjDO,IAAM,0BAA0B;AAAA;AAAA;AAAA;AAAA;;;AFqBhC,IAAM,mBAAN,cAA+B,WAAW;AAAA,EAC7B,OAAe,aAAa;AAAA,EAC5B,SAAiB;AAAA,EAC1B;AAAA,EACQ;AAAA,EACA;AAAA,EAEjB,YAAY,QAAwB;AAClC,UAAM,mBAAmB,MAAM,CAAC;AAChC,SAAK,iBAAiB;AACtB,SAAK,cAAc,iBAAiB,MAAM,IAAI,GAAG,aAAa,QAAQ;AACtE,SAAK,mBAAmB,sBAAsB,MAAM,SAAS,GAAG,aAAa,QAAQ;AAAA,EACvF;AAAA,EAES,MAA+B;AACtC,WAAO,KAAK;AAAA,EACd;AAAA,EAES,WAAyC;AAChD,WAAO,KAAK;AAAA,EACd;AAAA,EAES,WAA2C;AAClD,WAAO,QAAQ,QAAQ;AAAA,MACrB,MAAM,KAAK;AAAA,MACX,QAAQ,qBAAqB,KAAK,cAAc;AAAA,IAClD,CAAC;AAAA,EACH;AAAA,EAES,UAAU,QAA8C;AAC/D,WAAO,QAAQ,QAAQ;AAAA,EACzB;AACF;","names":[]}

package/dist/{chunk-MSNVGH6T.js → chunk-4YJMDF2S.js}

@@ -1,6 +1,6 @@
 import {
   redactGDriveConfig
-} from "./chunk-XIURBEVZ.js";
+} from "./chunk-NMZBJOFW.js";
 
 // src/resource/gdrive/gdrive.ts
 import {
@@ -76,8 +76,6 @@ var GDriveResource = class {
   getState() {
     return Promise.resolve({
       type: this.kind,
-      needsOverride: true,
-      redactedFields: ["clientSecret", "refreshToken"],
       config: redactGDriveConfig(this.config)
     });
   }
@@ -89,4 +87,4 @@ var GDriveResource = class {
 export {
   GDriveResource
 };
-//# sourceMappingURL=chunk-MSNVGH6T.js.map
+//# sourceMappingURL=chunk-4YJMDF2S.js.map

package/dist/chunk-4YJMDF2S.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resource/gdrive/gdrive.ts"],"sourcesContent":["// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport {\n  type FileStat,\n  GDRIVE_COMMANDS,\n  GDRIVE_PROMPT,\n  GDRIVE_VFS_OPS,\n  GDriveAccessor,\n  type IndexCacheStore,\n  PathSpec,\n  RAMIndexCacheStore,\n  type RegisteredCommand,\n  type RegisteredOp,\n  type Resource,\n  ResourceName,\n  TokenManager,\n  gdriveRead,\n  gdriveReaddir,\n  gdriveResolveGlob,\n  gdriveStat,\n} from '@struktoai/mirage-core'\nimport { redactGDriveConfig, type GDriveConfig, type GDriveConfigRedacted } from './config.ts'\n\nexport interface GDriveResourceState {\n  type: string\n  config: GDriveConfigRedacted\n}\n\nexport class GDriveResource implements Resource {\n  readonly kind: string = ResourceName.GDRIVE\n  readonly isRemote: boolean = true\n  readonly indexTtl: number = 86_400\n  readonly prompt: string = GDRIVE_PROMPT\n  readonly config: GDriveConfig\n  readonly accessor: GDriveAccessor\n  readonly index: IndexCacheStore\n\n  constructor(config: GDriveConfig) {\n    this.config = config\n    const tm = new TokenManager({\n      clientId: config.clientId,\n      ...(config.clientSecret !== undefined ? { clientSecret: config.clientSecret } : {}),\n      refreshToken: config.refreshToken,\n      ...(config.refreshFn !== undefined ? { refreshFn: config.refreshFn } : {}),\n    })\n    this.accessor = new GDriveAccessor({ tokenManager: tm })\n    this.index = new RAMIndexCacheStore({ ttl: 86_400 })\n  }\n\n  open(): Promise<void> {\n    return Promise.resolve()\n  }\n\n  close(): Promise<void> {\n    return Promise.resolve()\n  }\n\n  commands(): readonly RegisteredCommand[] {\n    return GDRIVE_COMMANDS\n  }\n\n  ops(): readonly RegisteredOp[] {\n    return GDRIVE_VFS_OPS\n  }\n\n  readFile(p: PathSpec): Promise<Uint8Array> {\n    return gdriveRead(this.accessor, p, this.index)\n  }\n\n  readdir(p: PathSpec): Promise<string[]> {\n    return gdriveReaddir(this.accessor, p, this.index)\n  }\n\n  stat(p: PathSpec): Promise<FileStat> {\n    return gdriveStat(this.accessor, p, this.index)\n  }\n\n  async fingerprint(p: PathSpec): Promise<string | null> {\n    const lookup = await this.index.get(p.original)\n    return lookup.entry?.remoteTime ?? null\n  }\n\n  glob(paths: readonly PathSpec[], prefix = ''): Promise<PathSpec[]> {\n    const effective =\n      prefix !== ''\n        ? paths.map((p) =>\n            p.prefix !== ''\n              ? p\n              : new PathSpec({\n                  original: p.original,\n                  directory: p.directory,\n                  ...(p.pattern !== null ? { pattern: p.pattern } : {}),\n                  resolved: p.resolved,\n                  prefix,\n                }),\n          )\n        : paths\n    return gdriveResolveGlob(this.accessor, effective, this.index)\n  }\n\n  getState(): Promise<GDriveResourceState> {\n    return Promise.resolve({\n      type: this.kind,\n      config: redactGDriveConfig(this.config),\n    })\n  }\n\n  loadState(_state: GDriveResourceState): Promise<void> {\n    return Promise.resolve()\n  }\n}\n"],"mappings":";;;;;AAcA;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAIA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQA,IAAM,iBAAN,MAAyC;AAAA,EACrC,OAAe,aAAa;AAAA,EAC5B,WAAoB;AAAA,EACpB,WAAmB;AAAA,EACnB,SAAiB;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,QAAsB;AAChC,SAAK,SAAS;AACd,UAAM,KAAK,IAAI,aAAa;AAAA,MAC1B,UAAU,OAAO;AAAA,MACjB,GAAI,OAAO,iBAAiB,SAAY,EAAE,cAAc,OAAO,aAAa,IAAI,CAAC;AAAA,MACjF,cAAc,OAAO;AAAA,MACrB,GAAI,OAAO,cAAc,SAAY,EAAE,WAAW,OAAO,UAAU,IAAI,CAAC;AAAA,IAC1E,CAAC;AACD,SAAK,WAAW,IAAI,eAAe,EAAE,cAAc,GAAG,CAAC;AACvD,SAAK,QAAQ,IAAI,mBAAmB,EAAE,KAAK,MAAO,CAAC;AAAA,EACrD;AAAA,EAEA,OAAsB;AACpB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,QAAuB;AACrB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,WAAyC;AACvC,WAAO;AAAA,EACT;AAAA,EAEA,MAA+B;AAC7B,WAAO;AAAA,EACT;AAAA,EAEA,SAAS,GAAkC;AACzC,WAAO,WAAW,KAAK,UAAU,GAAG,KAAK,KAAK;AAAA,EAChD;AAAA,EAEA,QAAQ,GAAgC;AACtC,WAAO,cAAc,KAAK,UAAU,GAAG,KAAK,KAAK;AAAA,EACnD;AAAA,EAEA,KAAK,GAAgC;AACnC,WAAO,WAAW,KAAK,UAAU,GAAG,KAAK,KAAK;AAAA,EAChD;AAAA,EAEA,MAAM,YAAY,GAAqC;AACrD,UAAM,SAAS,MAAM,KAAK,MAAM,IAAI,EAAE,QAAQ;AAC9C,WAAO,OAAO,OAAO,cAAc;AAAA,EACrC;AAAA,EAEA,KAAK,OAA4B,SAAS,IAAyB;AACjE,UAAM,YACJ,WAAW,KACP,MAAM;AAAA,MAAI,CAAC,MACT,EAAE,WAAW,KACT,IACA,IAAI,SAAS;AAAA,QACX,UAAU,EAAE;AAAA,QACZ,WAAW,EAAE;AAAA,QACb,GAAI,EAAE,YAAY,OAAO,EAAE,SAAS,EAAE,QAAQ,IAAI,CAAC;AAAA,QACnD,UAAU,EAAE;AAAA,QACZ;AAAA,MACF,CAAC;AAAA,IACP,IACA;AACN,WAAO,kBAAkB,KAAK,UAAU,WAAW,KAAK,KAAK;AAAA,EAC/D;AAAA,EAEA,WAAyC;AACvC,WAAO,QAAQ,QAAQ;AAAA,MACrB,MAAM,KAAK;AAAA,MACX,QAAQ,mBAAmB,KAAK,MAAM;AAAA,IACxC,CAAC;AAAA,EACH;AAAA,EAEA,UAAU,QAA4C;AACpD,WAAO,QAAQ,QAAQ;AAAA,EACzB;AACF;","names":[]}

package/dist/chunk-54NTYJEO.js

@@ -0,0 +1,13 @@
+// src/resource/gmail/config.ts
+import {
+  GoogleConfigSchema,
+  normalizeGoogleConfig,
+  redactGoogleConfig
+} from "@struktoai/mirage-core";
+
+export {
+  GoogleConfigSchema,
+  normalizeGoogleConfig,
+  redactGoogleConfig
+};
+//# sourceMappingURL=chunk-54NTYJEO.js.map

package/dist/chunk-54NTYJEO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resource/gmail/config.ts"],"sourcesContent":["// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nexport {\n  GoogleConfigSchema as GmailConfigSchema,\n  normalizeGoogleConfig as normalizeGmailConfig,\n  redactGoogleConfig as redactGmailConfig,\n  type GoogleConfig as GmailConfig,\n  type GoogleConfigRedacted as GmailConfigRedacted,\n} from '@struktoai/mirage-core'\n"],"mappings":";AAcA;AAAA,EACwB;AAAA,EACG;AAAA,EACH;AAAA,OAGjB;","names":[]}

package/dist/chunk-63GZEZW4.js

@@ -0,0 +1,79 @@
+import {
+  S3Resource
+} from "./chunk-XFREXNA2.js";
+
+// src/resource/seaweedfs/seaweedfs.ts
+import {
+  remapCommandsResource,
+  remapOpsResource,
+  ResourceName
+} from "@struktoai/mirage-core";
+
+// src/resource/seaweedfs/config.ts
+import { redactConfigWithSchema, secretSchema, z } from "@struktoai/mirage-core";
+var SeaweedFSConfigSchema = z.object({
+  bucket: z.string(),
+  presignedUrlProvider: secretSchema(
+    z.custom((value) => typeof value === "function")
+  ),
+  endpoint: z.string().optional(),
+  region: z.string().optional(),
+  defaultContentType: z.string().optional()
+});
+function seaweedfsToS3Config(config) {
+  return {
+    bucket: config.bucket,
+    presignedUrlProvider: config.presignedUrlProvider,
+    ...config.region !== void 0 ? { region: config.region } : {},
+    ...config.endpoint !== void 0 ? { endpoint: config.endpoint } : {},
+    ...config.defaultContentType !== void 0 ? { defaultContentType: config.defaultContentType } : {}
+  };
+}
+function redactSeaweedFSConfig(config) {
+  return redactConfigWithSchema(SeaweedFSConfigSchema, config);
+}
+
+// src/resource/seaweedfs/prompt.ts
+var SEAWEEDFS_BROWSER_PROMPT = `{prefix}
+  Remote SeaweedFS bucket (S3-compatible gateway) accessed via presigned URLs (browser runtime).
+  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.
+  Listing operations require the presigner to sign LIST/COPY operations in
+  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.`;
+
+// src/resource/seaweedfs/seaweedfs.ts
+var SeaweedFSResource = class extends S3Resource {
+  kind = ResourceName.SEAWEEDFS;
+  prompt = SEAWEEDFS_BROWSER_PROMPT;
+  seaweedfsConfig;
+  seaweedfsOps;
+  seaweedfsCommands;
+  constructor(config) {
+    super(seaweedfsToS3Config(config));
+    this.seaweedfsConfig = config;
+    this.seaweedfsOps = remapOpsResource(super.ops(), ResourceName.SEAWEEDFS);
+    this.seaweedfsCommands = remapCommandsResource(super.commands(), ResourceName.SEAWEEDFS);
+  }
+  ops() {
+    return this.seaweedfsOps;
+  }
+  commands() {
+    return this.seaweedfsCommands;
+  }
+  getState() {
+    return Promise.resolve({
+      type: this.kind,
+      config: redactSeaweedFSConfig(this.seaweedfsConfig)
+    });
+  }
+  loadState(_state) {
+    return Promise.resolve();
+  }
+};
+
+export {
+  seaweedfsToS3Config,
+  redactSeaweedFSConfig,
+  SEAWEEDFS_BROWSER_PROMPT,
+  SeaweedFSResource
+};
+//# sourceMappingURL=chunk-63GZEZW4.js.map

package/dist/chunk-63GZEZW4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resource/seaweedfs/seaweedfs.ts","../src/resource/seaweedfs/config.ts","../src/resource/seaweedfs/prompt.ts"],"sourcesContent":["// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport {\n  remapCommandsResource,\n  remapOpsResource,\n  ResourceName,\n  type RegisteredCommand,\n  type RegisteredOp,\n} from '@struktoai/mirage-core'\nimport { S3Resource } from '../s3/s3.ts'\nimport {\n  redactSeaweedFSConfig,\n  seaweedfsToS3Config,\n  type SeaweedFSConfig,\n  type SeaweedFSConfigRedacted,\n} from './config.ts'\nimport { SEAWEEDFS_BROWSER_PROMPT } from './prompt.ts'\n\nexport interface SeaweedFSResourceState {\n  type: string\n  config: SeaweedFSConfigRedacted\n}\n\nexport class SeaweedFSResource extends S3Resource {\n  override readonly kind: string = ResourceName.SEAWEEDFS\n  override readonly prompt: string = SEAWEEDFS_BROWSER_PROMPT\n  readonly seaweedfsConfig: SeaweedFSConfig\n  private readonly seaweedfsOps: readonly RegisteredOp[]\n  private readonly seaweedfsCommands: readonly RegisteredCommand[]\n\n  constructor(config: SeaweedFSConfig) {\n    super(seaweedfsToS3Config(config))\n    this.seaweedfsConfig = config\n    this.seaweedfsOps = remapOpsResource(super.ops(), ResourceName.SEAWEEDFS)\n    this.seaweedfsCommands = remapCommandsResource(super.commands(), ResourceName.SEAWEEDFS)\n  }\n\n  override ops(): readonly RegisteredOp[] {\n    return this.seaweedfsOps\n  }\n\n  override commands(): readonly RegisteredCommand[] {\n    return this.seaweedfsCommands\n  }\n\n  override getState(): Promise<SeaweedFSResourceState> {\n    return Promise.resolve({\n      type: this.kind,\n      config: redactSeaweedFSConfig(this.seaweedfsConfig),\n    })\n  }\n\n  override loadState(_state: SeaweedFSResourceState): Promise<void> {\n    return Promise.resolve()\n  }\n}\n","// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport { redactConfigWithSchema, secretSchema, z } from '@struktoai/mirage-core'\nimport type { S3BrowserPresignedUrlProvider, S3Config } from '../s3/config.ts'\n\nexport interface SeaweedFSConfig {\n  bucket: string\n  presignedUrlProvider: S3BrowserPresignedUrlProvider\n  endpoint?: string\n  region?: string\n  defaultContentType?: string\n}\n\nexport interface SeaweedFSConfigRedacted extends Omit<SeaweedFSConfig, 'presignedUrlProvider'> {\n  presignedUrlProvider: '<REDACTED>'\n}\n\nexport const SeaweedFSConfigSchema = z.object({\n  bucket: z.string(),\n  presignedUrlProvider: secretSchema(\n    z.custom<S3BrowserPresignedUrlProvider>((value) => typeof value === 'function'),\n  ),\n  endpoint: z.string().optional(),\n  region: z.string().optional(),\n  defaultContentType: z.string().optional(),\n})\n\nexport function seaweedfsToS3Config(config: SeaweedFSConfig): S3Config {\n  return {\n    bucket: config.bucket,\n    presignedUrlProvider: config.presignedUrlProvider,\n    ...(config.region !== undefined ? { region: config.region } : {}),\n    ...(config.endpoint !== undefined ? { endpoint: config.endpoint } : {}),\n    ...(config.defaultContentType !== undefined\n      ? { defaultContentType: config.defaultContentType }\n      : {}),\n  }\n}\n\nexport function redactSeaweedFSConfig(config: SeaweedFSConfig): SeaweedFSConfigRedacted {\n  return redactConfigWithSchema(SeaweedFSConfigSchema, config) as unknown as SeaweedFSConfigRedacted\n}\n","// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nexport const SEAWEEDFS_BROWSER_PROMPT = `{prefix}\n  Remote SeaweedFS bucket (S3-compatible gateway) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE — see S3BrowserPresignedUrlProvider docs.`\n"],"mappings":";;;;;AAcA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;;;ACNP,SAAS,wBAAwB,cAAc,SAAS;AAejD,IAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,QAAQ,EAAE,OAAO;AAAA,EACjB,sBAAsB;AAAA,IACpB,EAAE,OAAsC,CAAC,UAAU,OAAO,UAAU,UAAU;AAAA,EAChF;AAAA,EACA,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,oBAAoB,EAAE,OAAO,EAAE,SAAS;AAC1C,CAAC;AAEM,SAAS,oBAAoB,QAAmC;AACrE,SAAO;AAAA,IACL,QAAQ,OAAO;AAAA,IACf,sBAAsB,OAAO;AAAA,IAC7B,GAAI,OAAO,WAAW,SAAY,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC;AAAA,IAC/D,GAAI,OAAO,aAAa,SAAY,EAAE,UAAU,OAAO,SAAS,IAAI,CAAC;AAAA,IACrE,GAAI,OAAO,uBAAuB,SAC9B,EAAE,oBAAoB,OAAO,mBAAmB,IAChD,CAAC;AAAA,EACP;AACF;AAEO,SAAS,sBAAsB,QAAkD;AACtF,SAAO,uBAAuB,uBAAuB,MAAM;AAC7D;;;ACvCO,IAAM,2BAA2B;AAAA;AAAA;AAAA;AAAA;;;AFqBjC,IAAM,oBAAN,cAAgC,WAAW;AAAA,EAC9B,OAAe,aAAa;AAAA,EAC5B,SAAiB;AAAA,EAC1B;AAAA,EACQ;AAAA,EACA;AAAA,EAEjB,YAAY,QAAyB;AACnC,UAAM,oBAAoB,MAAM,CAAC;AACjC,SAAK,kBAAkB;AACvB,SAAK,eAAe,iBAAiB,MAAM,IAAI,GAAG,aAAa,SAAS;AACxE,SAAK,oBAAoB,sBAAsB,MAAM,SAAS,GAAG,aAAa,SAAS;AAAA,EACzF;AAAA,EAES,MAA+B;AACtC,WAAO,KAAK;AAAA,EACd;AAAA,EAES,WAAyC;AAChD,WAAO,KAAK;AAAA,EACd;AAAA,EAES,WAA4C;AACnD,WAAO,QAAQ,QAAQ;AAAA,MACrB,MAAM,KAAK;AAAA,MACX,QAAQ,sBAAsB,KAAK,eAAe;AAAA,IACpD,CAAC;AAAA,EACH;AAAA,EAES,UAAU,QAA+C;AAChE,WAAO,QAAQ,QAAQ;AAAA,EACzB;AACF;","names":[]}