@filepad/agent-access-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Filepad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# @filepad/agent-access-sdk
+
+Official SDK for connecting external AI agents to Filepad workspaces via **Agent Access**.
+
+## What is Agent Access?
+
+Agent Access is Filepad's scoped API for external agents. It lets an outside agent:
+
+- Read workspace context (folders, files, skills, search)
+- Read visible workspace signals
+- Read and propose updates to the agent's own home profile
+- Create safe artifacts under `artifacts/`
+- Propose reviewable edits to allowed files
+- Report activity events
+- Receive addressed mailbox notifications from Filepad
+
+Agent Access **does not** let external agents directly mutate active workspace files, approve their own proposals, or execute automations.
+
+## Install
+
+```bash
+npm install @filepad/agent-access-sdk
+```
+
+Requires Node.js 18+.
+
+## Quick Start
+
+```typescript
+import { FilepadAgentClient } from '@filepad/agent-access-sdk';
+
+const client = new FilepadAgentClient({
+  baseUrl: 'https://app.filepad.ai/api',
+  workspaceId: 'ws_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+  keyId: 'ik_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+  secret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
+});
+
+// Verify credentials
+const { scopes } = await client.verifyCredentials();
+console.log('Granted scopes:', scopes);
+
+// Read environment
+const env = await client.getEnvironment();
+console.log('Folders:', env.folders.map(f => f.name));
+
+// Search workspace
+const search = await client.search('quarterly report', { type: 'keyword', limit: 5 });
+console.log('Results:', search.results.length);
+
+// Create artifact
+const { artifact } = await client.createArtifact({
+  title: 'Agent Report',
+  text: '# Summary\n\nGenerated by external agent.',
+});
+console.log('Artifact:', artifact.id);
+
+// Emit event
+const { eventId } = await client.createEvent({
+  eventType: 'agent.task.completed',
+  payload: { artifactId: artifact.id },
+});
+console.log('Event:', eventId);
+
+// Query visible signals
+const signals = await client.getSignals({ status: 'suggested', limit: 10 });
+console.log('Signals:', signals.signals.length);
+if (signals.signals[0]) {
+  const signal = await client.getSignal(signals.signals[0].id);
+  console.log('Signal:', signal.findingTypeKey, signal.status);
+}
+
+// Read Filepad callbacks addressed to this integration
+const mailbox = await client.getMailbox({ unreadOnly: true, limit: 20 });
+console.log('Unread mailbox items:', mailbox.items.length);
+if (mailbox.items.length > 0) {
+  await client.ackMailbox(mailbox.items.map(item => item.id));
+}
+
+// Read this key's agent home profile
+const profile = await client.getAgentProfile();
+console.log('Agent profile key:', profile.keyId);
+```
+
+## Authentication
+
+Every request is signed with HMAC-SHA256 using your Agent Access key.
+
+Create a key in Filepad:
+1. Open a workspace
+2. Go to **Settings → Agent Access**
+3. Click **Create Key**
+4. Copy the **Key ID** and **Secret** (shown once)
+
+The SDK handles signing automatically. You only need to provide `keyId` and `secret` to the client.
+
+## API Reference
+
+### `FilepadAgentClient`
+
+#### `verifyCredentials()`
+Returns the integration key id, integration id, workspace id, and granted scopes.
+
+#### `getEnvironment()`
+Returns workspace folders and their status.
+
+#### `getFileTree()`
+Returns all visible files and folders.
+
+#### `getFile(fileNodeId)`
+Reads a file by its node id.
+
+#### `getPrompts()` / `getMcpPrompts()` / `getMcpResources()`
+Discover skills and resources.
+
+#### `search(query, options?)`
+Search indexed workspace context.
+
+#### `createArtifact(params)`
+Create a note artifact under `artifacts/`.
+
+#### `proposeEdit(params)`
+Propose a reviewable edit to an allowed file.
+
+#### `createEvent(params)`
+Emit an activity event.
+
+#### `createSignal(params)`
+Create a signal (requires `signals:write` scope).
+
+#### `getSignals(filters?)`
+Query visible workspace signals by type, severity, status, limit, or cursor. Requires `env:read`.
+
+#### `getSignal(signalId)`
+Read one visible workspace signal by id. Requires `env:read`.
+
+#### `getMailbox(options?)`
+Read Filepad mailbox notifications addressed to this integration. Requires `notifications:read`.
+
+#### `ackMailbox(ids)`
+Acknowledge processed mailbox notification ids. Requires `notifications:read`.
+
+#### `getAgentProfile(options?)`
+Read this integration's agent home profile files under `agents/integrations/{keyId}/`. Requires `env:read`.
+
+#### `updateAgentProfile(params)`
+Propose an append or replacement update to one profile file. Requires `env:read` and `files:propose`; the change waits for human review.
+
+### Error Handling
+
+The SDK throws typed errors:
+
+- `AuthenticationError` — invalid signature or expired key
+- `ForbiddenScopeError` — missing required scope
+- `NotFoundError` — file or resource not found
+- `RateLimitError` — too many requests
+- `ProposalPathError` — proposal target is not allowed
+- `StaleVersionError` — base version changed during proposal
+
+All errors extend `FilepadAgentError` with `code`, `message`, and `status` properties.
+
+```typescript
+import { FilepadAgentError, AuthenticationError } from '@filepad/agent-access-sdk';
+
+try {
+  await client.getFile('fn_...');
+} catch (err) {
+  if (err instanceof AuthenticationError) {
+    console.error('Check your key id and secret');
+  } else if (err instanceof FilepadAgentError) {
+    console.error(err.code, err.message);
+  }
+}
+```
+
+## Scope Reference
+
+| Scope | What it allows |
+|-------|----------------|
+| `env:read` | Read folders, file tree, file content, search, skill prompts, MCP resources, and visible signals |
+| `artifacts:write` | Create note artifacts under `artifacts/` |
+| `files:propose` | Create reviewable edit proposals for allowed files |
+| `memory:read` | Read memory entries |
+| `events.write` | Write agent activity events |
+| `signals:write` | Create signals for automation triggers |
+| `notifications:read` | Read and acknowledge Filepad mailbox notifications addressed to this integration |
+
+## License
+
+MIT

package/SECURITY.md

@@ -0,0 +1,23 @@
+# Security Policy
+
+## Supported Versions
+
+Security fixes are provided for the latest published `0.x` release of `@filepad/agent-access-sdk`.
+
+## Reporting a Vulnerability
+
+Email security reports to `security@filepad.ai`.
+
+Please include:
+
+- package name and version
+- affected API surface
+- reproduction steps
+- expected impact
+
+Do not open a public issue for vulnerabilities involving authentication, request signing, secrets, or workspace data exposure.
+
+## Secret Handling
+
+Agent Access secrets are bearer-equivalent credentials. They are shown once in Filepad and should be stored only in the target agent runtime or secret manager. Rotate a key if the secret is copied into chat, logs, screenshots, or source control.
+

package/dist/auth.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Serialize a request body into the canonical string representation.
+ * - undefined/null → ''
+ * - string → used as-is
+ * - object → JSON.stringify with standard compact formatting
+ */
+export declare function serializeBody(body: unknown): string;
+/**
+ * Compute SHA-256 hex digest of a string.
+ */
+export declare function sha256Hex(data: string): string;
+/**
+ * Build the canonical signing string.
+ */
+export declare function buildCanonicalString(params: {
+    method: string;
+    pathWithQuery: string;
+    timestampSeconds: string;
+    nonce: string;
+    rawBody: string;
+}): string;
+/**
+ * Sign a Filepad Agent Access request.
+ *
+ * @param keyId     The integration key id (ik_...)
+ * @param secret    The plaintext secret
+ * @param method    HTTP method in any case
+ * @param pathWithQuery Full path including query string, exactly as sent
+ * @param body      Optional request body
+ * @returns Headers and raw body to send
+ */
+export declare function signRequest(keyId: string, secret: string, method: string, pathWithQuery: string, body?: unknown): {
+    headers: Record<string, string>;
+    rawBody: string;
+};
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAInD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAST;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,OAAO,GACb;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA2BtD"}

package/dist/auth.js

@@ -0,0 +1,71 @@
+// FILE MEMO: HMAC-SHA256 request signing for Filepad Agent Access.
+// Canonical string: METHOD\npathWithQuery\ntimestampSeconds\nnonce\nsha256(rawBody)
+import { createHash, createHmac, randomUUID } from 'node:crypto';
+/**
+ * Serialize a request body into the canonical string representation.
+ * - undefined/null → ''
+ * - string → used as-is
+ * - object → JSON.stringify with standard compact formatting
+ */
+export function serializeBody(body) {
+    if (body === undefined || body === null)
+        return '';
+    if (typeof body === 'string')
+        return body;
+    return JSON.stringify(body);
+}
+/**
+ * Compute SHA-256 hex digest of a string.
+ */
+export function sha256Hex(data) {
+    return createHash('sha256').update(Buffer.from(data, 'utf8')).digest('hex');
+}
+/**
+ * Build the canonical signing string.
+ */
+export function buildCanonicalString(params) {
+    const bodyHash = sha256Hex(params.rawBody);
+    return [
+        params.method.toUpperCase(),
+        params.pathWithQuery,
+        params.timestampSeconds,
+        params.nonce,
+        bodyHash,
+    ].join('\n');
+}
+/**
+ * Sign a Filepad Agent Access request.
+ *
+ * @param keyId     The integration key id (ik_...)
+ * @param secret    The plaintext secret
+ * @param method    HTTP method in any case
+ * @param pathWithQuery Full path including query string, exactly as sent
+ * @param body      Optional request body
+ * @returns Headers and raw body to send
+ */
+export function signRequest(keyId, secret, method, pathWithQuery, body) {
+    const timestamp = Math.floor(Date.now() / 1000).toString();
+    const nonce = randomUUID();
+    const rawBody = serializeBody(body);
+    const canonical = buildCanonicalString({
+        method,
+        pathWithQuery,
+        timestampSeconds: timestamp,
+        nonce,
+        rawBody,
+    });
+    const signature = createHmac('sha256', secret)
+        .update(canonical, 'utf8')
+        .digest('base64');
+    return {
+        rawBody,
+        headers: {
+            'content-type': 'application/json',
+            'x-integration-key-id': keyId,
+            'x-integration-timestamp': timestamp,
+            'x-integration-nonce': nonce,
+            'x-integration-signature': signature,
+        },
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,oFAAoF;AAEpF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACnD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAMpC;IACC,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO;QACL,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE;QAC3B,MAAM,CAAC,aAAa;QACpB,MAAM,CAAC,gBAAgB;QACvB,MAAM,CAAC,KAAK;QACZ,QAAQ;KACT,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,MAAc,EACd,MAAc,EACd,aAAqB,EACrB,IAAc;IAEd,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,oBAAoB,CAAC;QACrC,MAAM;QACN,aAAa;QACb,gBAAgB,EAAE,SAAS;QAC3B,KAAK;QACL,OAAO;KACR,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC3C,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC;SACzB,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEpB,OAAO;QACL,OAAO;QACP,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,sBAAsB,EAAE,KAAK;YAC7B,yBAAyB,EAAE,SAAS;YACpC,qBAAqB,EAAE,KAAK;YAC5B,yBAAyB,EAAE,SAAS;SACrC;KACF,CAAC;AACJ,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,56 @@
+import type { FilepadAgentClientConfig, GetAgentApiCapabilitiesResponse, GetAgentApiEnvironmentResponse, GetAgentApiFileTreeResponse, GetAgentApiPromptsResponse, GetMcpPromptsResponse, GetMcpResourcesResponse, SearchAgentApiWorkspaceResponse, GetAgentApiFileResponse, CreateAgentApiArtifactRequest, CreateAgentApiArtifactResponse, CreateAgentApiEventRequest, CreateAgentApiEventResponse, CreateAgentApiSignalRequest, CreateAgentApiSignalResponse, AgentSignal, AgentSignalSeverity, AgentSignalStatus, ListAgentSignalsResponse, ListAgentMailboxResponse, AckAgentMailboxResponse, AgentProfile, AgentProfileField, UpdateAgentProfileRequest, UpdateAgentProfileResponse } from './types.js';
+import { McpAdapter } from './mcp.js';
+export declare class FilepadAgentClient {
+    private readonly http;
+    private readonly workspaceId;
+    readonly mcp: McpAdapter;
+    constructor(config: FilepadAgentClientConfig);
+    /** Verify credentials by calling capabilities. Returns agent identity and granted scopes. */
+    verifyCredentials(): Promise<GetAgentApiCapabilitiesResponse>;
+    getCapabilities(): Promise<GetAgentApiCapabilitiesResponse>;
+    getEnvironment(): Promise<GetAgentApiEnvironmentResponse>;
+    getFileTree(): Promise<GetAgentApiFileTreeResponse>;
+    getPrompts(): Promise<GetAgentApiPromptsResponse>;
+    getMcpPrompts(): Promise<GetMcpPromptsResponse>;
+    getMcpResources(): Promise<GetMcpResourcesResponse>;
+    getFile(fileNodeId: string): Promise<GetAgentApiFileResponse>;
+    getMailbox(options?: {
+        limit?: number;
+        unreadOnly?: boolean;
+        cursor?: string;
+    }): Promise<ListAgentMailboxResponse>;
+    getSignals(filters?: {
+        findingTypeKey?: string | undefined;
+        severity?: AgentSignalSeverity | undefined;
+        status?: AgentSignalStatus | undefined;
+        limit?: number | undefined;
+        cursor?: string | undefined;
+    }): Promise<ListAgentSignalsResponse>;
+    getSignal(signalId: string): Promise<AgentSignal>;
+    getAgentProfile(options?: {
+        fields?: AgentProfileField[] | undefined;
+    }): Promise<AgentProfile>;
+    search(query: string, options?: {
+        type?: 'semantic' | 'keyword' | 'hybrid';
+        limit?: number;
+    }): Promise<SearchAgentApiWorkspaceResponse>;
+    createArtifact(params: CreateAgentApiArtifactRequest): Promise<CreateAgentApiArtifactResponse>;
+    createEvent(params: Omit<CreateAgentApiEventRequest, 'occurredAt' | 'idempotencyKey'> & Partial<Pick<CreateAgentApiEventRequest, 'occurredAt' | 'idempotencyKey'>>): Promise<CreateAgentApiEventResponse>;
+    createSignal(params: Omit<CreateAgentApiSignalRequest, 'idempotencyKey'> & Partial<Pick<CreateAgentApiSignalRequest, 'idempotencyKey'>>): Promise<CreateAgentApiSignalResponse>;
+    ackMailbox(ids: string[]): Promise<AckAgentMailboxResponse>;
+    updateAgentProfile(params: UpdateAgentProfileRequest): Promise<UpdateAgentProfileResponse>;
+    proposeEdit(params: {
+        fileNodeId: string;
+        baseVersionId: string;
+        summary: string;
+        newText: string;
+        baseTextSha256?: string;
+        instruction?: string;
+        toolName?: string;
+    }): Promise<{
+        proposalId: string;
+        artifactId: string;
+        baseVersionId: string;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,208 @@
+// FILE MEMO: High-level FilepadAgentClient with validation, guardrails, and typed helpers.
+import { FilepadAgentHttpClient } from './endpoints.js';
+import { McpAdapter } from './mcp.js';
+const AGENT_PROFILE_FIELDS = [
+    'identity',
+    'learnings',
+    'goals',
+    'timeline',
+];
+function fileNameForProfileField(field) {
+    return `${field}.md`;
+}
+function appendAgentProfileEntry(existingText, content) {
+    const trimmedContent = content.trim();
+    if (!trimmedContent)
+        return existingText;
+    const entry = [`## ${new Date().toISOString()}`, '', trimmedContent, ''].join('\n');
+    const headingMatch = existingText.match(/^(# .+\n)/);
+    if (!headingMatch || headingMatch.index !== 0) {
+        return `${entry}\n${existingText}`.trimEnd() + '\n';
+    }
+    const heading = headingMatch[1] ?? '';
+    const rest = existingText.slice(heading.length).trimStart();
+    return `${heading}\n${entry}${rest}`.trimEnd() + '\n';
+}
+export class FilepadAgentClient {
+    http;
+    workspaceId;
+    mcp;
+    constructor(config) {
+        this.http = new FilepadAgentHttpClient(config);
+        this.workspaceId = config.workspaceId;
+        this.mcp = new McpAdapter(this);
+    }
+    // ── Validation ──
+    /** Verify credentials by calling capabilities. Returns agent identity and granted scopes. */
+    async verifyCredentials() {
+        return this.http.get('/agent-api/v1/capabilities');
+    }
+    // ── Read ──
+    async getCapabilities() {
+        return this.http.get('/agent-api/v1/capabilities');
+    }
+    async getEnvironment() {
+        return this.http.get(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/environment`);
+    }
+    async getFileTree() {
+        return this.http.get(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/file-tree`);
+    }
+    async getPrompts() {
+        return this.http.get(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/prompts`);
+    }
+    async getMcpPrompts() {
+        return this.http.get(`/mcp/v1/workspaces/${encodeURIComponent(this.workspaceId)}/prompts`);
+    }
+    async getMcpResources() {
+        return this.http.get(`/mcp/v1/workspaces/${encodeURIComponent(this.workspaceId)}/resources`);
+    }
+    async getFile(fileNodeId) {
+        return this.http.get(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/files/${encodeURIComponent(fileNodeId)}`);
+    }
+    async getMailbox(options) {
+        const params = new URLSearchParams();
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        if (options?.unreadOnly !== undefined) {
+            params.set('unreadOnly', String(options.unreadOnly));
+        }
+        if (options?.cursor)
+            params.set('cursor', options.cursor);
+        const query = params.toString();
+        return this.http.get(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/mailbox${query ? `?${query}` : ''}`);
+    }
+    async getSignals(filters) {
+        const params = new URLSearchParams();
+        if (filters?.findingTypeKey) {
+            params.set('findingTypeKey', filters.findingTypeKey);
+        }
+        if (filters?.severity)
+            params.set('severity', filters.severity);
+        if (filters?.status)
+            params.set('status', filters.status);
+        if (filters?.limit)
+            params.set('limit', String(filters.limit));
+        if (filters?.cursor)
+            params.set('cursor', filters.cursor);
+        const query = params.toString();
+        return this.http.get(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/signals${query ? `?${query}` : ''}`);
+    }
+    async getSignal(signalId) {
+        return this.http.get(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/signals/${encodeURIComponent(signalId)}`);
+    }
+    async getAgentProfile(options) {
+        const capabilities = await this.getCapabilities();
+        const requestedFields = options?.fields ?? [...AGENT_PROFILE_FIELDS];
+        const tree = await this.getFileTree();
+        const pathById = new Map();
+        for (const node of tree.nodes) {
+            if (node.parentId === null) {
+                pathById.set(node.id, node.name);
+                continue;
+            }
+            const parentPath = pathById.get(node.parentId);
+            if (parentPath)
+                pathById.set(node.id, `${parentPath}/${node.name}`);
+        }
+        const files = {};
+        for (const field of requestedFields) {
+            const expectedPath = `agents/integrations/${capabilities.agent.keyId}/${fileNameForProfileField(field)}`;
+            const node = tree.nodes.find((candidate) => pathById.get(candidate.id) === expectedPath);
+            if (!node)
+                continue;
+            const file = await this.getFile(node.id);
+            files[field] = {
+                field,
+                path: expectedPath,
+                fileNodeId: node.id,
+                artifactId: file.artifact?.id ?? null,
+                baseVersionId: file.latestVersion?.id ?? null,
+                text: file.content.kind === 'inlineText'
+                    ? (file.content.text ?? '')
+                    : '',
+            };
+        }
+        return {
+            keyId: capabilities.agent.keyId,
+            files,
+        };
+    }
+    async search(query, options) {
+        const body = {
+            query,
+            ...(options?.type ? { type: options.type } : {}),
+            ...(options?.limit ? { limit: options.limit } : {}),
+        };
+        return this.http.post(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/search`, body);
+    }
+    // ── Write ──
+    async createArtifact(params) {
+        return this.http.post(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/artifacts`, params);
+    }
+    async createEvent(params) {
+        const body = {
+            eventType: params.eventType,
+            payload: params.payload,
+            occurredAt: params.occurredAt ?? new Date().toISOString(),
+            idempotencyKey: params.idempotencyKey ?? crypto.randomUUID(),
+        };
+        return this.http.post(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/events`, body);
+    }
+    async createSignal(params) {
+        const body = {
+            findingTypeKey: params.findingTypeKey,
+            summary: params.summary,
+            severity: params.severity,
+            value: params.value,
+            idempotencyKey: params.idempotencyKey ?? crypto.randomUUID(),
+        };
+        return this.http.post(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/signals`, body);
+    }
+    async ackMailbox(ids) {
+        return this.http.post(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/mailbox/ack`, { ids });
+    }
+    async updateAgentProfile(params) {
+        const mode = params.mode ?? 'append';
+        const profile = await this.getAgentProfile({ fields: [params.field] });
+        const profileFile = profile.files[params.field];
+        if (!profileFile) {
+            throw new Error(`Agent profile file is missing for field: ${params.field}`);
+        }
+        if (!profileFile.baseVersionId || !profileFile.artifactId) {
+            throw new Error(`Agent profile file is not editable for field: ${params.field}`);
+        }
+        const newText = mode === 'replace'
+            ? params.content
+            : appendAgentProfileEntry(profileFile.text, params.content);
+        const proposal = await this.proposeEdit({
+            fileNodeId: profileFile.fileNodeId,
+            baseVersionId: profileFile.baseVersionId,
+            summary: `Update agent ${params.field} profile`,
+            newText,
+            instruction: 'Agent profile update requested through filepad_update_profile.',
+            toolName: 'filepad_update_profile',
+        });
+        return {
+            ...proposal,
+            field: params.field,
+            mode,
+            status: 'pending_review',
+        };
+    }
+    // ── Proposals ──
+    async proposeEdit(params) {
+        return this.http.post(`/agent-api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/files/${encodeURIComponent(params.fileNodeId)}/proposals`, {
+            baseVersionId: params.baseVersionId,
+            editorKind: 'plainText',
+            summary: params.summary,
+            ops: {
+                type: 'plain_text_replace',
+                text: params.newText,
+                ...(params.baseTextSha256 ? { baseTextSha256: params.baseTextSha256 } : {}),
+                ...(params.instruction ? { instruction: params.instruction } : {}),
+                ...(params.toolName ? { toolName: params.toolName } : {}),
+            },
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/endpoints.d.ts

@@ -0,0 +1,16 @@
+import type { FilepadAgentClientConfig } from './types.js';
+export declare class FilepadAgentHttpClient {
+    private readonly baseUrl;
+    private readonly keyId;
+    private readonly secret;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly retryDelayMs;
+    constructor(config: FilepadAgentClientConfig);
+    private buildUrl;
+    private fetchWithTimeout;
+    request<T>(method: string, pathWithQuery: string, body?: unknown): Promise<T>;
+    get<T>(pathWithQuery: string): Promise<T>;
+    post<T>(pathWithQuery: string, body?: unknown): Promise<T>;
+}
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../src/endpoints.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,wBAAwB,EAAiB,MAAM,YAAY,CAAC;AAc1E,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,EAAE,wBAAwB;IAS5C,OAAO,CAAC,QAAQ;YAIF,gBAAgB;IAcxB,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,CAAC,CAAC;IAkEb,GAAG,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzC,IAAI,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAG3D"}