@airstore/sdk 0.1.0 → 0.1.3

package/README.md

@@ -1,6 +1,6 @@
 # @airstore/sdk
 
-Official TypeScript SDK for the [Airstore](https://airstore.ai) API. Provision workspaces, manage connections, configure smart folders, and generate mount tokens — all from your backend.
+Official TypeScript SDK for the [Airstore](https://airstore.ai) API. Provision workspaces, manage connections, configure source views, and generate mount tokens — all from your backend.
 
 ## Installation
 
@@ -51,8 +51,8 @@ async function provisionUser(
     refreshToken: gmailTokens.refreshToken,
   });
 
-  // 4. Set up smart folders for what the agent should see
-  await airstore.smartFolders.create(ws.external_id, {
+  // 4. Set up source views for what the agent should see
+  await airstore.views.create(ws.external_id, {
     integration: 'gmail',
     name: 'Recent Emails',
     guidance: 'Last 7 days of emails from the inbox',
@@ -143,32 +143,72 @@ const connections = await airstore.connections.list('ws_abc123');
 await airstore.connections.del('ws_abc123', 'conn_abc123');
 ```
 
-### Smart Folders
+### Source Views
+
+Source views come in two modes: **smart** (LLM-inferred from natural language) and **query** (structured per-integration filters).
 
 ```typescript
-// Create
-const folder = await airstore.smartFolders.create('ws_abc123', {
+// Smart mode — describe what you want in natural language
+const view = await airstore.views.create('ws_abc123', {
   integration: 'gmail',
   name: 'Important Emails',
   guidance: 'Emails marked as important from the last month',
   outputFormat: 'folder', // or 'file'
 });
 
+// Query mode — auto-detected when filter is provided
+const view2 = await airstore.views.create('ws_abc123', {
+  integration: 'gmail',
+  name: 'Unread from boss',
+  filter: { from: 'boss@company.com', is_unread: true },
+});
+
+// Query mode with GitHub content types
+const prView = await airstore.views.create('ws_abc123', {
+  integration: 'github',
+  name: 'Open PRs',
+  filter: {
+    repo: 'acme/api',
+    type: 'prs',
+    state: 'open',
+    content_type: 'diff', // 'markdown' | 'diff' | 'json' | 'raw'
+  },
+});
+
 // List all
-const folders = await airstore.smartFolders.list('ws_abc123');
+const views = await airstore.views.list('ws_abc123');
 
 // Retrieve by path
-const folder = await airstore.smartFolders.retrieve('ws_abc123', '/Sources/gmail/Important Emails');
+const found = await airstore.views.retrieve('ws_abc123', '/sources/gmail/Important Emails');
 
 // Update
-const updated = await airstore.smartFolders.update('ws_abc123', 'query_abc', {
+const updated = await airstore.views.update('ws_abc123', 'view_abc', {
   guidance: 'Updated guidance text',
 });
 
+// Sync — re-execute the query and refresh cached files
+const result = await airstore.views.sync('ws_abc123', 'view_abc');
+console.log(`${result.results_count} total, ${result.new_results} new`);
+
 // Delete
-await airstore.smartFolders.del('ws_abc123', 'query_abc');
+await airstore.views.del('ws_abc123', 'view_abc');
 ```
 
+#### Per-integration filter fields
+
+Each integration accepts a typed filter object:
+
+| Integration | Key fields |
+|---|---|
+| `gmail` | `from`, `to`, `subject`, `label`, `newer_than`, `older_than`, `has_attachment`, `is_unread`, `is_starred` |
+| `github` | `repo` (required), `type`, `state`, `label`, `author`, `content_type` |
+| `gdrive` | `name_contains`, `mime_type`, `shared_with_me`, `starred`, `modified_after`, `modified_before`, `folder_id` |
+| `notion` | `search` |
+| `slack` | `channel`, `from`, `after`, `before`, `has_link`, `has_reaction` |
+| `linear` | `type`, `team`, `state`, `assignee`, `priority`, `label` |
+| `posthog` | `type`, `query`, `project_id` |
+| `web` | `mode`, `url`, `query`, `include_paths` |
+
 ### Tokens
 
 ```typescript
@@ -237,7 +277,7 @@ const entries = await airstore.fs.list('ws_abc123', { path: '/' });
 
 // Read file contents
 const content = await airstore.fs.read('ws_abc123', {
-  path: '/Sources/gmail/inbox/email.txt',
+  path: '/sources/gmail/inbox/email.txt',
 });
 
 // Get directory tree
@@ -247,7 +287,7 @@ const tree = await airstore.fs.tree('ws_abc123', {
 });
 
 // Stat a file
-const meta = await airstore.fs.stat('ws_abc123', '/Sources/gmail/inbox/email.txt');
+const meta = await airstore.fs.stat('ws_abc123', '/sources/gmail/inbox/email.txt');
 ```
 
 ## Per-Request Options

package/dist/cjs/airstore.js

@@ -4,122 +4,83 @@ exports.Airstore = void 0;
 const client_js_1 = require("./client.js");
 const workspaces_js_1 = require("./resources/workspaces.js");
 const connections_js_1 = require("./resources/connections.js");
-const smart_folders_js_1 = require("./resources/smart-folders.js");
+const views_js_1 = require("./resources/views.js");
 const tokens_js_1 = require("./resources/tokens.js");
 const members_js_1 = require("./resources/members.js");
 const oauth_js_1 = require("./resources/oauth.js");
 const filesystem_js_1 = require("./resources/filesystem.js");
+const access_log_js_1 = require("./resources/access-log.js");
 /**
  * The Airstore SDK client.
  *
- * Create an instance with your API key to interact with workspaces,
- * connections, smart folders, tokens, members, the virtual filesystem,
- * and OAuth sessions.
- *
  * @example Basic provisioning flow
  * ```ts
  * import Airstore from '@airstore/sdk';
  *
  * const airstore = new Airstore({ apiKey: 'org_...' });
  *
- * // 1. Create a workspace for a new user
+ * // 1. Create a workspace
  * const ws = await airstore.workspaces.create({ name: 'user-123' });
  *
- * // 2. Connect their Gmail with existing OAuth tokens
+ * // 2. Connect Gmail
  * await airstore.connections.create(ws.external_id, {
  *   integrationType: 'gmail',
  *   accessToken: existingAccessToken,
  *   refreshToken: existingRefreshToken,
  * });
  *
- * // 3. Set up a smart folder
- * await airstore.smartFolders.create(ws.external_id, {
+ * // 3. Create a source view (smart mode — LLM-inferred)
+ * const view = await airstore.views.create(ws.external_id, {
  *   integration: 'gmail',
  *   name: 'Recent Emails',
  *   guidance: 'Last 7 days of emails from the inbox',
  * });
  *
- * // 4. Generate a mount token for the user's VM
+ * // 4. Or create a source view (query mode — structured filter)
+ * await airstore.views.create(ws.external_id, {
+ *   integration: 'gmail',
+ *   name: 'Unread from boss',
+ *   filter: { from: 'boss@company.com', is_unread: true },
+ * });
+ *
+ * // 5. Sync a view to refresh its metadata
+ * const result = await airstore.views.sync(ws.external_id, view.external_id);
+ * console.log(result.results_count, result.new_results);
+ *
+ * // 6. Generate a mount token
  * const token = await airstore.tokens.create(ws.external_id, {
  *   email: 'agent@internal',
  *   name: 'vm-mount',
  * });
- * // Pass token.token to: airstore start --token <token>
- * ```
- *
- * @example Per-request options
- * ```ts
- * const ws = await airstore.workspaces.list({
- *   timeout: 10_000,
- *   maxRetries: 5,
- * });
  * ```
  */
 class Airstore extends client_js_1.CoreClient {
-    /**
-     * Manage workspaces.
-     *
-     * Workspaces are the top-level container for connections, smart folders,
-     * members, and the virtual filesystem.
-     */
+    /** Manage workspaces. */
     workspaces;
-    /**
-     * Manage connections (integrations) within a workspace.
-     *
-     * Pass existing OAuth tokens or API keys to connect external services
-     * like Gmail, GitHub, Notion, etc.
-     */
+    /** Manage connections (integrations) within a workspace. */
     connections;
-    /**
-     * Manage smart folders (filesystem queries).
-     *
-     * Smart folders use LLM inference to automatically organize and filter
-     * data from connected integrations into virtual folders or files.
-     */
-    smartFolders;
-    /**
-     * Manage workspace-scoped authentication tokens.
-     *
-     * Tokens are used for CLI mounting and per-workspace programmatic access.
-     */
+    /** Manage source views — materialized queries over connected data sources. */
+    views;
+    /** Manage workspace-scoped authentication tokens. */
     tokens;
-    /**
-     * Manage workspace members.
-     *
-     * Members are users with roles (admin, member, viewer) in a workspace.
-     */
+    /** Manage workspace members. */
     members;
-    /**
-     * OAuth session management for interactive connection setup.
-     *
-     * Use this for browser-redirect flows where users authorize
-     * integrations themselves.
-     */
+    /** OAuth session management for interactive connection setup. */
     oauth;
-    /**
-     * Read-only access to the workspace virtual filesystem.
-     *
-     * Browse directories, read files, and inspect metadata across
-     * all connected integrations.
-     */
+    /** Read-only access to the workspace virtual filesystem. */
     fs;
-    /**
-     * Create a new Airstore SDK client.
-     *
-     * @param opts - Client configuration. At minimum, provide an `apiKey`
-     *   or set the `AIRSTORE_API_KEY` environment variable.
-     *
-     * @throws {AirstoreError} If no API key is provided.
-     */
+    /** Query the workspace access log. */
+    accessLog;
     constructor(opts) {
         super(opts);
         this.workspaces = new workspaces_js_1.Workspaces(this);
         this.connections = new connections_js_1.Connections(this);
-        this.smartFolders = new smart_folders_js_1.SmartFolders(this);
+        this.views = new views_js_1.Views(this);
         this.tokens = new tokens_js_1.Tokens(this);
         this.members = new members_js_1.Members(this);
         this.oauth = new oauth_js_1.OAuth(this);
         this.fs = new filesystem_js_1.Filesystem(this);
+        this.accessLog = new access_log_js_1.AccessLog(this);
     }
 }
 exports.Airstore = Airstore;

package/dist/cjs/airstore.js.map

@@ -1 +1 @@
-{"version":3,"file":"airstore.js","sourceRoot":"","sources":["../../src/airstore.ts"],"names":[],"mappings":";;;AAAA,2CAA6D;AAC7D,6DAAuD;AACvD,+DAAyD;AACzD,mEAA4D;AAC5D,qDAA+C;AAC/C,uDAAiD;AACjD,mDAA6C;AAC7C,6DAAuD;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAa,QAAS,SAAQ,sBAAU;IACtC;;;;;OAKG;IACM,UAAU,CAAa;IAEhC;;;;;OAKG;IACM,WAAW,CAAc;IAElC;;;;;OAKG;IACM,YAAY,CAAe;IAEpC;;;;OAIG;IACM,MAAM,CAAS;IAExB;;;;OAIG;IACM,OAAO,CAAU;IAE1B;;;;;OAKG;IACM,KAAK,CAAQ;IAEtB;;;;;OAKG;IACM,EAAE,CAAa;IAExB;;;;;;;OAOG;IACH,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,UAAU,GAAG,IAAI,0BAAU,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,4BAAW,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,IAAI,+BAAY,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,IAAI,oBAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,gBAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,EAAE,GAAG,IAAI,0BAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AAzED,4BAyEC;AAED,kBAAe,QAAQ,CAAC"}
+{"version":3,"file":"airstore.js","sourceRoot":"","sources":["../../src/airstore.ts"],"names":[],"mappings":";;;AAAA,2CAA6D;AAC7D,6DAAuD;AACvD,+DAAyD;AACzD,mDAA6C;AAC7C,qDAA+C;AAC/C,uDAAiD;AACjD,mDAA6C;AAC7C,6DAAuD;AACvD,6DAAsD;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAa,QAAS,SAAQ,sBAAU;IACtC,yBAAyB;IAChB,UAAU,CAAa;IAChC,4DAA4D;IACnD,WAAW,CAAc;IAClC,8EAA8E;IACrE,KAAK,CAAQ;IACtB,qDAAqD;IAC5C,MAAM,CAAS;IACxB,gCAAgC;IACvB,OAAO,CAAU;IAC1B,iEAAiE;IACxD,KAAK,CAAQ;IACtB,4DAA4D;IACnD,EAAE,CAAa;IACxB,sCAAsC;IAC7B,SAAS,CAAY;IAE9B,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,UAAU,GAAG,IAAI,0BAAU,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,4BAAW,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,gBAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,IAAI,oBAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,gBAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,EAAE,GAAG,IAAI,0BAAU,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,yBAAS,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF;AA7BD,4BA6BC;AAED,kBAAe,QAAQ,CAAC"}

package/dist/cjs/index.js

@@ -1,7 +1,7 @@
 "use strict";
 /** @module @airstore/sdk */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION = exports.Filesystem = exports.OAuth = exports.Members = exports.Tokens = exports.SmartFolders = exports.Connections = exports.Workspaces = exports.APIConnectionTimeoutError = exports.APIConnectionError = exports.InternalServerError = exports.RateLimitError = exports.UnprocessableEntityError = exports.ConflictError = exports.NotFoundError = exports.PermissionDeniedError = exports.AuthenticationError = exports.APIError = exports.AirstoreError = exports.default = exports.Airstore = void 0;
+exports.VERSION = exports.WebModes = exports.PostHogResourceTypes = exports.LinearPriorities = exports.LinearStates = exports.LinearResourceTypes = exports.GDriveMimeTypes = exports.GitHubContentTypes = exports.GitHubStates = exports.GitHubResourceTypes = exports.GmailLabels = exports.Integrations = exports.ViewModes = exports.AccessLog = exports.Filesystem = exports.OAuth = exports.Members = exports.Tokens = exports.Views = exports.Connections = exports.Workspaces = exports.APIConnectionTimeoutError = exports.APIConnectionError = exports.InternalServerError = exports.RateLimitError = exports.UnprocessableEntityError = exports.ConflictError = exports.NotFoundError = exports.PermissionDeniedError = exports.AuthenticationError = exports.APIError = exports.AirstoreError = exports.default = exports.Airstore = void 0;
 // ── Main client ──────────────────────────────────────────────────────────────
 var airstore_js_1 = require("./airstore.js");
 Object.defineProperty(exports, "Airstore", { enumerable: true, get: function () { return airstore_js_1.Airstore; } });
@@ -24,8 +24,8 @@ var workspaces_js_1 = require("./resources/workspaces.js");
 Object.defineProperty(exports, "Workspaces", { enumerable: true, get: function () { return workspaces_js_1.Workspaces; } });
 var connections_js_1 = require("./resources/connections.js");
 Object.defineProperty(exports, "Connections", { enumerable: true, get: function () { return connections_js_1.Connections; } });
-var smart_folders_js_1 = require("./resources/smart-folders.js");
-Object.defineProperty(exports, "SmartFolders", { enumerable: true, get: function () { return smart_folders_js_1.SmartFolders; } });
+var views_js_1 = require("./resources/views.js");
+Object.defineProperty(exports, "Views", { enumerable: true, get: function () { return views_js_1.Views; } });
 var tokens_js_1 = require("./resources/tokens.js");
 Object.defineProperty(exports, "Tokens", { enumerable: true, get: function () { return tokens_js_1.Tokens; } });
 var members_js_1 = require("./resources/members.js");
@@ -34,6 +34,21 @@ var oauth_js_1 = require("./resources/oauth.js");
 Object.defineProperty(exports, "OAuth", { enumerable: true, get: function () { return oauth_js_1.OAuth; } });
 var filesystem_js_1 = require("./resources/filesystem.js");
 Object.defineProperty(exports, "Filesystem", { enumerable: true, get: function () { return filesystem_js_1.Filesystem; } });
+var access_log_js_1 = require("./resources/access-log.js");
+Object.defineProperty(exports, "AccessLog", { enumerable: true, get: function () { return access_log_js_1.AccessLog; } });
+var views_js_2 = require("./types/views.js");
+Object.defineProperty(exports, "ViewModes", { enumerable: true, get: function () { return views_js_2.ViewModes; } });
+Object.defineProperty(exports, "Integrations", { enumerable: true, get: function () { return views_js_2.Integrations; } });
+Object.defineProperty(exports, "GmailLabels", { enumerable: true, get: function () { return views_js_2.GmailLabels; } });
+Object.defineProperty(exports, "GitHubResourceTypes", { enumerable: true, get: function () { return views_js_2.GitHubResourceTypes; } });
+Object.defineProperty(exports, "GitHubStates", { enumerable: true, get: function () { return views_js_2.GitHubStates; } });
+Object.defineProperty(exports, "GitHubContentTypes", { enumerable: true, get: function () { return views_js_2.GitHubContentTypes; } });
+Object.defineProperty(exports, "GDriveMimeTypes", { enumerable: true, get: function () { return views_js_2.GDriveMimeTypes; } });
+Object.defineProperty(exports, "LinearResourceTypes", { enumerable: true, get: function () { return views_js_2.LinearResourceTypes; } });
+Object.defineProperty(exports, "LinearStates", { enumerable: true, get: function () { return views_js_2.LinearStates; } });
+Object.defineProperty(exports, "LinearPriorities", { enumerable: true, get: function () { return views_js_2.LinearPriorities; } });
+Object.defineProperty(exports, "PostHogResourceTypes", { enumerable: true, get: function () { return views_js_2.PostHogResourceTypes; } });
+Object.defineProperty(exports, "WebModes", { enumerable: true, get: function () { return views_js_2.WebModes; } });
 // ── Version ──────────────────────────────────────────────────────────────────
 var version_js_1 = require("./version.js");
 Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_js_1.VERSION; } });

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4BAA4B;;;AAE5B,gFAAgF;AAChF,6CAA8D;AAArD,uGAAA,QAAQ,OAAA;AAAE,sGAAA,QAAQ,OAAW;AAGtC,gFAAgF;AAChF,yCAYqB;AAXnB,0GAAA,aAAa,OAAA;AACb,qGAAA,QAAQ,OAAA;AACR,gHAAA,mBAAmB,OAAA;AACnB,kHAAA,qBAAqB,OAAA;AACrB,0GAAA,aAAa,OAAA;AACb,0GAAA,aAAa,OAAA;AACb,qHAAA,wBAAwB,OAAA;AACxB,2GAAA,cAAc,OAAA;AACd,gHAAA,mBAAmB,OAAA;AACnB,+GAAA,kBAAkB,OAAA;AAClB,sHAAA,yBAAyB,OAAA;AAG3B,gFAAgF;AAChF,2DAAuD;AAA9C,2GAAA,UAAU,OAAA;AACnB,6DAAyD;AAAhD,6GAAA,WAAW,OAAA;AACpB,iEAA4D;AAAnD,gHAAA,YAAY,OAAA;AACrB,mDAA+C;AAAtC,mGAAA,MAAM,OAAA;AACf,qDAAiD;AAAxC,qGAAA,OAAO,OAAA;AAChB,iDAA6C;AAApC,iGAAA,KAAK,OAAA;AACd,2DAAuD;AAA9C,2GAAA,UAAU,OAAA;AAYnB,gFAAgF;AAChF,2CAAuC;AAA9B,qGAAA,OAAO,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4BAA4B;;;AAE5B,gFAAgF;AAChF,6CAA8D;AAArD,uGAAA,QAAQ,OAAA;AAAE,sGAAA,QAAQ,OAAW;AAGtC,gFAAgF;AAChF,yCAYqB;AAXnB,0GAAA,aAAa,OAAA;AACb,qGAAA,QAAQ,OAAA;AACR,gHAAA,mBAAmB,OAAA;AACnB,kHAAA,qBAAqB,OAAA;AACrB,0GAAA,aAAa,OAAA;AACb,0GAAA,aAAa,OAAA;AACb,qHAAA,wBAAwB,OAAA;AACxB,2GAAA,cAAc,OAAA;AACd,gHAAA,mBAAmB,OAAA;AACnB,+GAAA,kBAAkB,OAAA;AAClB,sHAAA,yBAAyB,OAAA;AAG3B,gFAAgF;AAChF,2DAAuD;AAA9C,2GAAA,UAAU,OAAA;AACnB,6DAAyD;AAAhD,6GAAA,WAAW,OAAA;AACpB,iDAA6C;AAApC,iGAAA,KAAK,OAAA;AACd,mDAA+C;AAAtC,mGAAA,MAAM,OAAA;AACf,qDAAiD;AAAxC,qGAAA,OAAO,OAAA;AAChB,iDAA6C;AAApC,iGAAA,KAAK,OAAA;AACd,2DAAuD;AAA9C,2GAAA,UAAU,OAAA;AACnB,2DAAsD;AAA7C,0GAAA,SAAS,OAAA;AAkClB,6CAa0B;AAZxB,qGAAA,SAAS,OAAA;AACT,wGAAA,YAAY,OAAA;AACZ,uGAAA,WAAW,OAAA;AACX,+GAAA,mBAAmB,OAAA;AACnB,wGAAA,YAAY,OAAA;AACZ,8GAAA,kBAAkB,OAAA;AAClB,2GAAA,eAAe,OAAA;AACf,+GAAA,mBAAmB,OAAA;AACnB,wGAAA,YAAY,OAAA;AACZ,4GAAA,gBAAgB,OAAA;AAChB,gHAAA,oBAAoB,OAAA;AACpB,oGAAA,QAAQ,OAAA;AAgBV,gFAAgF;AAChF,2CAAuC;AAA9B,qGAAA,OAAO,OAAA"}

package/dist/cjs/resources/access-log.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessLog = void 0;
+/**
+ * Query the workspace access log.
+ *
+ * Every file read through the virtual filesystem is recorded with token
+ * counts, compression outcome, timing, and a `source_uri` that pins
+ * the content back to its upstream origin.
+ *
+ * @example List recent reads
+ * ```ts
+ * const page = await airstore.accessLog.list("ws-abc", {
+ *   start: Date.now() - 3600_000, // last hour
+ *   limit: 50,
+ * });
+ * for (const r of page.reads) {
+ *   console.log(r.source_uri, r.original_tokens, "->", r.compressed_tokens);
+ * }
+ * ```
+ *
+ * @example Get a summary
+ * ```ts
+ * const s = await airstore.accessLog.summary("ws-abc", {
+ *   start: Date.now() - 86400_000,
+ * });
+ * console.log(`${s.total_reads} reads, ${s.compression_ratio} ratio`);
+ * ```
+ *
+ * @example Replay a read by source URI
+ * ```ts
+ * const content = await airstore.accessLog.read("ws-abc", "github://abc123");
+ * ```
+ */
+class AccessLog {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List access log reads for a workspace.
+     *
+     * Supports cursor-based pagination and optional time-window filtering.
+     *
+     * @param workspaceId - Workspace external ID (UUID).
+     * @param params - Filtering and pagination options.
+     * @param options - Per-request overrides.
+     */
+    async list(workspaceId, params, options) {
+        const query = {};
+        if (params?.start !== undefined)
+            query.start = String(params.start);
+        if (params?.end !== undefined)
+            query.end = String(params.end);
+        if (params?.cursor !== undefined)
+            query.cursor = params.cursor;
+        if (params?.limit !== undefined)
+            query.limit = String(params.limit);
+        if (params?.session !== undefined)
+            query.session = params.session;
+        return this.client.request('GET', `/workspaces/${workspaceId}/access-log`, undefined, query, options);
+    }
+    /**
+     * Get an aggregated summary of access log reads.
+     *
+     * Returns totals, compression ratio, per-integration breakdown,
+     * outcome distribution, and top paths by token consumption.
+     *
+     * @param workspaceId - Workspace external ID (UUID).
+     * @param params - Time window and session options.
+     * @param options - Per-request overrides.
+     */
+    async summary(workspaceId, params, options) {
+        const query = {};
+        if (params?.start !== undefined)
+            query.start = String(params.start);
+        if (params?.end !== undefined)
+            query.end = String(params.end);
+        if (params?.session !== undefined)
+            query.session = params.session;
+        return this.client.request('GET', `/workspaces/${workspaceId}/access-log/summary`, undefined, query, options);
+    }
+    /**
+     * Read content directly from an upstream source using a `source_uri`.
+     *
+     * This bypasses the source-view/query layer entirely. Even if the
+     * materialized view has changed, the source_uri lets you pull the
+     * exact content that was originally read.
+     *
+     * @param workspaceId - Workspace external ID (UUID).
+     * @param sourceUri - Source URI from an access log entry (e.g., "github://abc123").
+     * @param options - Per-request overrides.
+     * @returns The raw content as an ArrayBuffer.
+     */
+    async read(workspaceId, sourceUri, options) {
+        const resp = await this.client.rawRequest('GET', `/workspaces/${workspaceId}/access-log/read`, { params: { uri: sourceUri }, ...options });
+        return resp.arrayBuffer();
+    }
+}
+exports.AccessLog = AccessLog;
+//# sourceMappingURL=access-log.js.map

package/dist/cjs/resources/access-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-log.js","sourceRoot":"","sources":["../../../src/resources/access-log.ts"],"names":[],"mappings":";;;AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAa,SAAS;IACS;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,MAA4B,EAC5B,OAAwB;QAExB,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpE,IAAI,MAAM,EAAE,GAAG,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9D,IAAI,MAAM,EAAE,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC/D,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpE,IAAI,MAAM,EAAE,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAElE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,aAAa,EACvC,SAAS,EACT,KAAK,EACL,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,OAAO,CACX,WAAmB,EACnB,MAA+B,EAC/B,OAAwB;QAExB,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpE,IAAI,MAAM,EAAE,GAAG,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9D,IAAI,MAAM,EAAE,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAElE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,qBAAqB,EAC/C,SAAS,EACT,KAAK,EACL,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,SAAiB,EACjB,OAAwB;QAExB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CACvC,KAAK,EACL,eAAe,WAAW,kBAAkB,EAC5C,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,CAC3C,CAAC;QACF,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;CACF;AAtFD,8BAsFC"}

package/dist/cjs/resources/filesystem.js

@@ -5,13 +5,13 @@ exports.Filesystem = void 0;
  * Read-only access to the workspace virtual filesystem.
  *
  * The filesystem provides a unified view of all connected integrations,
- * smart folders, tools, and user-uploaded files.
+ * source views, tools, and user-uploaded files.
  *
  * @example
  * ```ts
  * const listing = await airstore.fs.list("ws_abc", { path: "/" });
  * const content = await airstore.fs.read("ws_abc", {
- *   path: "/Sources/gmail/inbox/email.txt",
+ *   path: "/sources/gmail/inbox/email.txt",
  * });
  * ```
  */
@@ -44,6 +44,7 @@ class Filesystem {
      * @param opts.path - File path to read.
      * @param opts.offset - Byte offset to start reading from.
      * @param opts.length - Number of bytes to read.
+     * @param opts.compression - Compression strategy: 'strip', 'distill', or 'chain'. Omit to disable.
      * @param options - Per-request overrides.
      * @returns File contents as a string.
      *
@@ -55,6 +56,8 @@ class Filesystem {
             params['offset'] = String(opts.offset);
         if (opts.length !== undefined)
             params['length'] = String(opts.length);
+        if (opts.compression !== undefined)
+            params['compression'] = opts.compression;
         const resp = await this.client.rawRequest('GET', `/workspaces/${workspaceId}/fs/read`, { params, ...options });
         return resp.text();
     }

package/dist/cjs/resources/filesystem.js.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../../src/resources/filesystem.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;GAaG;AACH,MAAa,UAAU;IACQ;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,OAA0B,EAAE,EAC5B,OAAwB;QAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAExD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACtC,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,SAAS,EACT,MAAM,EACN,OAAO,CACR,CAAC;QACF,OAAQ,MAA2B,CAAC,OAAO,IAAI,EAAE,CAAC;IACpD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,IAAwD,EACxD,OAAwB;QAExB,MAAM,MAAM,GAA2B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEtE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CACvC,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CACvB,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,OAAwE,EAAE,EAC1E,OAAwB;QAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACxD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1E,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC;QACxD,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,SAAS,EACT,MAAM,EACN,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,IAAY,EACZ,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,SAAS,EACT,EAAE,IAAI,EAAE,EACR,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAtHD,gCAsHC"}
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../../src/resources/filesystem.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;GAaG;AACH,MAAa,UAAU;IACQ;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,OAA0B,EAAE,EAC5B,OAAwB;QAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAExD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACtC,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,SAAS,EACT,MAAM,EACN,OAAO,CACR,CAAC;QACF,OAAQ,MAA2B,CAAC,OAAO,IAAI,EAAE,CAAC;IACpD,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,IAKC,EACD,OAAwB;QAExB,MAAM,MAAM,GAA2B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAE7E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CACvC,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CACvB,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,OAAwE,EAAE,EAC1E,OAAwB;QAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACxD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1E,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC;QACxD,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,SAAS,EACT,MAAM,EACN,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,IAAY,EACZ,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,SAAS,EACT,EAAE,IAAI,EAAE,EACR,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AA7HD,gCA6HC"}

package/dist/cjs/resources/index.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Filesystem = exports.OAuth = exports.Members = exports.Tokens = exports.SmartFolders = exports.Connections = exports.Workspaces = void 0;
+exports.Filesystem = exports.OAuth = exports.Members = exports.Tokens = exports.Views = exports.Connections = exports.Workspaces = void 0;
 var workspaces_js_1 = require("./workspaces.js");
 Object.defineProperty(exports, "Workspaces", { enumerable: true, get: function () { return workspaces_js_1.Workspaces; } });
 var connections_js_1 = require("./connections.js");
 Object.defineProperty(exports, "Connections", { enumerable: true, get: function () { return connections_js_1.Connections; } });
-var smart_folders_js_1 = require("./smart-folders.js");
-Object.defineProperty(exports, "SmartFolders", { enumerable: true, get: function () { return smart_folders_js_1.SmartFolders; } });
+var views_js_1 = require("./views.js");
+Object.defineProperty(exports, "Views", { enumerable: true, get: function () { return views_js_1.Views; } });
 var tokens_js_1 = require("./tokens.js");
 Object.defineProperty(exports, "Tokens", { enumerable: true, get: function () { return tokens_js_1.Tokens; } });
 var members_js_1 = require("./members.js");

package/dist/cjs/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AACpB,uDAAkD;AAAzC,gHAAA,YAAY,OAAA;AACrB,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AACf,2CAAuC;AAA9B,qGAAA,OAAO,OAAA;AAChB,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AACd,iDAA6C;AAApC,2GAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AACpB,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AACd,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AACf,2CAAuC;AAA9B,qGAAA,OAAO,OAAA;AAChB,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AACd,iDAA6C;AAApC,2GAAA,UAAU,OAAA"}

package/dist/cjs/resources/oauth.js

@@ -38,6 +38,8 @@ class OAuth {
         const body = {
             integration_type: params.integrationType,
         };
+        if (params.workspaceId !== undefined)
+            body['workspace_id'] = params.workspaceId;
         if (params.returnTo !== undefined)
             body['return_to'] = params.returnTo;
         return this.client.request('POST', '/oauth/sessions', body, undefined, options);

package/dist/cjs/resources/oauth.js.map

@@ -1 +1 @@
-{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../../src/resources/oauth.ts"],"names":[],"mappings":";;;AAOA,4CAA6C;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,MAAa,KAAK;IACa;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,aAAa,CACjB,MAAgC,EAChC,OAAwB;QAExB,MAAM,IAAI,GAA4B;YACpC,gBAAgB,EAAE,MAAM,CAAC,eAAe;SACzC,CAAC;QACF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAEvE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,iBAAiB,EACjB,IAAI,EACJ,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CACd,SAAiB,EACjB,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,mBAAmB,SAAS,EAAE,EAC9B,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAI,CACR,SAAiB,EACjB,QAA2B,EAC3B,OAAwB;QAExB,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,OAAO,CAAC;QAC7C,MAAM,QAAQ,GAAG,QAAQ,EAAE,QAAQ,IAAI,KAAK,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QAEtC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAEzD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU;gBAAE,OAAO,MAAM,CAAC;YAChD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC9B,MAAM,IAAI,yBAAa,CACrB,yBAAyB,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAC3D,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,yBAAa,CAAC,iCAAiC,OAAO,IAAI,CAAC,CAAC;IACxE,CAAC;CACF;AAzFD,sBAyFC"}
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../../src/resources/oauth.ts"],"names":[],"mappings":";;;AAOA,4CAA6C;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,MAAa,KAAK;IACa;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,aAAa,CACjB,MAAgC,EAChC,OAAwB;QAExB,MAAM,IAAI,GAA4B;YACpC,gBAAgB,EAAE,MAAM,CAAC,eAAe;SACzC,CAAC;QACF,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC;QAChF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAEvE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,iBAAiB,EACjB,IAAI,EACJ,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CACd,SAAiB,EACjB,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,mBAAmB,SAAS,EAAE,EAC9B,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAI,CACR,SAAiB,EACjB,QAA2B,EAC3B,OAAwB;QAExB,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,OAAO,CAAC;QAC7C,MAAM,QAAQ,GAAG,QAAQ,EAAE,QAAQ,IAAI,KAAK,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QAEtC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAEzD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU;gBAAE,OAAO,MAAM,CAAC;YAChD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC9B,MAAM,IAAI,yBAAa,CACrB,yBAAyB,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAC3D,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,yBAAa,CAAC,iCAAiC,OAAO,IAAI,CAAC,CAAC;IACxE,CAAC;CACF;AA1FD,sBA0FC"}

package/dist/cjs/resources/views.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Views = void 0;
+/**
+ * Manage source views within a workspace.
+ *
+ * Source views are materialized queries over connected data sources.
+ * In **smart** mode the query is LLM-inferred from natural language guidance;
+ * in **query** mode the query is built from a structured per-integration filter.
+ *
+ * @example Smart mode (LLM-inferred)
+ * ```ts
+ * await airstore.views.create("ws_abc", {
+ *   integration: "gmail",
+ *   name: "Recent Emails",
+ *   guidance: "Last 7 days of emails",
+ * });
+ * ```
+ *
+ * @example Query mode (structured filter)
+ * ```ts
+ * await airstore.views.create("ws_abc", {
+ *   integration: "gmail",
+ *   name: "Unread from boss",
+ *   filter: { from: "boss@company.com", is_unread: true },
+ * });
+ * ```
+ */
+class Views {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new source view.
+     *
+     * If `filter` is provided the view is created in query mode;
+     * otherwise it uses smart mode with LLM inference from `guidance`.
+     */
+    async create(workspaceId, params, options) {
+        const body = {
+            integration: params.integration,
+            name: params.name,
+            output_format: params.outputFormat ?? 'folder',
+        };
+        if (params.guidance !== undefined)
+            body['guidance'] = params.guidance;
+        if (params.filter !== undefined)
+            body['filter'] = params.filter;
+        if (params.fileExt !== undefined)
+            body['file_ext'] = params.fileExt;
+        return this.client.request('POST', `/workspaces/${workspaceId}/fs/views`, body, undefined, options);
+    }
+    /** List all source views in a workspace. */
+    async list(workspaceId, options) {
+        const result = await this.client.request('GET', `/workspaces/${workspaceId}/fs/views/list`, undefined, undefined, options);
+        return result.views ?? [];
+    }
+    /** Retrieve a source view by its virtual filesystem path. */
+    async retrieve(workspaceId, viewPath, options) {
+        return this.client.request('GET', `/workspaces/${workspaceId}/fs/views`, undefined, { path: viewPath }, options);
+    }
+    /** Update an existing source view. */
+    async update(workspaceId, viewId, params, options) {
+        const body = {};
+        if (params.name !== undefined)
+            body['name'] = params.name;
+        if (params.guidance !== undefined)
+            body['guidance'] = params.guidance;
+        if (params.filter !== undefined)
+            body['filter'] = params.filter;
+        return this.client.request('PUT', `/workspaces/${workspaceId}/fs/views/${viewId}`, body, undefined, options);
+    }
+    /** Delete a source view. */
+    async del(workspaceId, viewId, options) {
+        await this.client.request('DELETE', `/workspaces/${workspaceId}/fs/views/${viewId}`, undefined, undefined, options);
+    }
+    /**
+     * Sync a source view — re-execute its query and refresh cached metadata.
+     *
+     * Idempotent and safe to call repeatedly. Returns the count of total
+     * and newly discovered results.
+     */
+    async sync(workspaceId, viewId, options) {
+        return this.client.request('POST', `/workspaces/${workspaceId}/fs/views/${viewId}/sync`, undefined, undefined, options);
+    }
+    /**
+     * List available resources for an integration (repos, channels, etc.).
+     *
+     * Used to populate filter dropdowns with real data from connected sources.
+     *
+     * @example
+     * ```ts
+     * const repos = await airstore.views.listResources("ws_abc", "github");
+     * // [{ id: "owner/repo", name: "owner/repo" }, ...]
+     * ```
+     */
+    async listResources(workspaceId, integration, resourceType, options) {
+        const params = {};
+        if (resourceType)
+            params['type'] = resourceType;
+        const result = await this.client.request('GET', `/workspaces/${workspaceId}/fs/sources/${integration}/resources`, undefined, params, options);
+        return result.resources ?? [];
+    }
+}
+exports.Views = Views;
+//# sourceMappingURL=views.js.map

package/dist/cjs/resources/views.js.map

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