@wyrd-company/ahp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wyrd Company
+
+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,200 @@
+# Agent Host Protocol (AHP) Server
+
+Production-shaped TypeScript implementation of the
+[Agent Host Protocol](https://github.com/microsoft/agent-host-protocol) server.
+
+The package target is `@wyrd-company/ahp-server`.
+
+## Current Scope
+
+This repository contains the AHP server library core:
+
+- A transport-agnostic AHP server core.
+- Compatibility tests against the published `@microsoft/agent-host-protocol` TypeScript client.
+- In-memory and filesystem-backed session stores behind a `SessionStore` interface.
+- A pluggable `AgentProvider` interface for optional agent adapters.
+- File-backed AHP `resource*` commands constrained to configured local roots.
+- Transport adapters are provided by sibling packages, with TypeScript as the first implementation:
+  - `@wyrd-company/ahp-nats` for NATS.io JSON-RPC text frames.
+  - `@wyrd-company/ahp-grpc` for gRPC bidirectional streaming over Unix domain sockets.
+- Optional provider adapters are published as sibling packages and are imported by host applications deliberately. Use `@wyrd-company/ahp-codex-app-server`, `@wyrd-company/ahp-claude-agent-sdk`, `@wyrd-company/ahp-cursor-sdk`, or `@wyrd-company/ahp-pi-agent` when wiring those runtimes.
+
+The normal test suite validates the AHP client/server flow, multiple simultaneous client transports, active-client tool routing, resource commands, and session storage.
+
+## Design Direction
+
+The server is intended to be protocol-compliant with the Microsoft AHP TypeScript client as the compatibility tie-breaker. If protocol documentation and VS Code reference behavior disagree, this project follows the TypeScript client.
+
+Adapters and transports are explicit packages. Users import optional packages and wire them into the server deliberately; runtime package discovery is not part of the first design. NATS and gRPC transports now live in sibling repos so their wire contracts can evolve toward multi-language implementations, with TypeScript as the initial implementation.
+
+State can start in memory for tests and short-lived runs, or use `FileSystemSessionStore` to persist session state into a mounted directory across devcontainer rebuilds. Adapter runtime handles are intentionally not serialized; provider sessions are recreated by adapter/server wiring.
+
+Security is scoped for local devcontainer/Docker-network use first. Remote and multi-tenant security are not implemented, but the transport and provider boundaries should not make that impossible later.
+
+File resource commands only support `file://` URIs. They are constrained to `resourceRoots`. If no root is configured, the current process working directory is used. Existing targets are checked through `realpath` so symlinks cannot escape the allowed root.
+
+## Implemented AHP Surface
+
+The server currently implements the minimum useful session surface:
+
+- `initialize`
+- `ping`
+- `reconnect` using snapshot fallback
+- `subscribe`
+- `unsubscribe`
+- `listSessions`
+- `resourceRead`
+- `resourceWrite`
+- `resourceList`
+- `resourceCopy`
+- `resourceDelete`
+- `resourceMove`
+- `resourceResolve`
+- `resourceMkdir`
+- `resolveSessionConfig`
+- `createSession`
+- `disposeSession`
+- `fetchTurns`
+- `completions`
+- `dispatchAction`
+
+`completions` currently returns an empty result. `resourceRequest` and `createResourceWatch` are not implemented yet.
+
+Session output is streamed as AHP `action` notifications using:
+
+- `session/responsePart`
+- `session/delta`
+- `session/turnComplete`
+- `session/error`
+
+Root session catalogue notifications are emitted for session add/remove/summary changes.
+
+## Active-Client Tools
+
+The server supports active-client tools as a provider-agnostic capability:
+
+- `createSession.activeClient` seeds the provider session with the current active-client tool set.
+- `session/activeClientToolsChanged` updates the provider session through the optional `AgentSession.setActiveClientTools` hook.
+- Clearing the active client, disposing the session, or disconnecting the active client removes those tools from the provider session.
+- Providers report active-client tool invocations through `AgentSessionContext.activeClientToolSink.reportInvocation`.
+- The server emits `session/toolCallStart` and `session/toolCallReady` with `contributor: { kind: "client", clientId }`.
+- `reportInvocation` resolves with the owning client's `session/toolCallComplete` result so provider runtimes can return tool output to their native tool-call flow.
+- The server owns trusted correlation for session URI, turn id, tool call id, tool name, and owning client id. Tool input is not trusted for those fields.
+- `session/toolCallComplete`, `session/toolCallContentChanged`, and `session/toolCallResultConfirmed` are accepted only from the active client that owns the server-recorded tool call.
+- Optional provider packages map active-client tools to provider-specific tool surfaces, such as Streamable HTTP MCP or runtime-native tool APIs.
+
+## Transport Packages
+
+`@wyrd-company/ahp-server` does not include a CLI and does not re-export transport packages. Host applications import the transports they need and pass their `AhpTransport` instances to `AhpServer.accept(...)`.
+
+The NATS transport package uses this subject convention:
+
+```text
+<namespace>.server.<serverId>.client.<clientId>.to-server
+<namespace>.server.<serverId>.client.<clientId>.to-client
+```
+
+The default namespace is `ahp`. Subject tokens are sanitized to NATS-safe token text by `@wyrd-company/ahp-nats`.
+
+The gRPC transport package exposes one bidirectional streaming RPC over a Unix domain socket:
+
+```protobuf
+service AhpTransport {
+  rpc Connect(stream AhpFrame) returns (stream AhpFrame);
+}
+
+message AhpFrame {
+  string text = 1;
+}
+```
+
+Each `text` value is one UTF-8 JSON-RPC AHP frame. The canonical proto lives in `@wyrd-company/ahp-grpc` under `proto/wyrd/ahp/transport/v1/transport.proto`.
+
+## Usage Sketch
+
+### User-Owned Host
+
+```ts
+import {
+  AhpServer,
+  FileSystemSessionStore,
+  createInProcessAhpClientTransport,
+} from '@wyrd-company/ahp-server';
+import { createClaudeAgentSdkProvider } from '@wyrd-company/ahp-claude-agent-sdk';
+import { createPiCodingAgentProvider } from '@wyrd-company/ahp-pi-agent';
+import {
+  createNatsServerTransport,
+  ahpNatsSubjects,
+} from '@wyrd-company/ahp-nats';
+import {
+  createGrpcUdsServer,
+} from '@wyrd-company/ahp-grpc';
+import { connect } from '@nats-io/transport-node';
+
+const natsConnection = await connect({ servers: process.env.NATS_URL });
+
+const subjects = ahpNatsSubjects({
+  serverId: 'devcontainer-1',
+  clientId: 'client-1',
+});
+
+const server = new AhpServer({
+  store: new FileSystemSessionStore({
+    directory: '/workspace-storage/ahp-server',
+  }),
+  defaultDirectory: 'file:///workspace',
+  resourceRoots: ['file:///workspace'],
+  providers: [
+    createPiCodingAgentProvider(),
+    createClaudeAgentSdkProvider({
+      defaultModel: 'claude-sonnet-4-6',
+      permissionMode: 'dontAsk',
+    }),
+  ],
+});
+
+await server.accept(createNatsServerTransport({
+  connection: natsConnection,
+  inboundSubject: subjects.clientToServer,
+  outboundSubject: subjects.serverToClient,
+}));
+
+const grpcServer = createGrpcUdsServer({
+  socketPath: '/tmp/ahp-server/ahp.sock',
+  onTransport: transport => {
+    void server.accept(transport);
+  },
+});
+await grpcServer.listen();
+
+const inProcess = createInProcessAhpClientTransport(server);
+
+// Pass `inProcess.transport` to an in-process AHP client, such as an A2A
+// adapter running in the same host process. The application still owns the
+// server, providers, and external AHP transports.
+```
+
+## Development
+
+```bash
+npm install
+npm run verify
+```
+
+`npm run verify` runs:
+
+- TypeScript typecheck
+- Node test suite
+- Build
+
+## References
+
+- AHP protocol and TypeScript client: `/workspaces/references/agent-host-protocol`
+- VS Code reference AHP server: `/workspaces/references/vscode/src/vs/platform/agentHost/node`
+- Pi Agent harness: `/workspaces/references/pi`
+- Claude Agent SDK: `/workspaces/references/claude-agent-sdk-typescript`
+
+## Planned Follow-Up
+
+- Remove the temporary `./provider-kit` compatibility re-export once consumers import `@wyrd-company/ahp-provider-kit` directly.
+- Create a separate reference host or CLI package if a reusable executable becomes useful.

package/dist/src/errors.d.ts

@@ -0,0 +1,28 @@
+interface JsonRpcErrorObject {
+    readonly code: number;
+    readonly message: string;
+    readonly data?: unknown;
+}
+export declare const JsonRpcErrorCodes: {
+    readonly ParseError: -32700;
+    readonly InvalidRequest: -32600;
+    readonly MethodNotFound: -32601;
+    readonly InvalidParams: -32602;
+    readonly InternalError: -32603;
+    readonly ProviderNotFound: -32002;
+    readonly SessionAlreadyExists: -32003;
+    readonly UnsupportedProtocolVersion: -32005;
+    readonly NotFound: -32008;
+    readonly PermissionDenied: -32009;
+    readonly AlreadyExists: -32010;
+    readonly Conflict: -32011;
+};
+export declare class AhpServerError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+    toJsonRpcError(): JsonRpcErrorObject;
+}
+export declare function toJsonRpcError(error: unknown): JsonRpcErrorObject;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAapB,CAAC;AAEX,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAOzD,cAAc,IAAI,kBAAkB;CAKrC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAQjE"}

package/dist/src/errors.js

@@ -0,0 +1,39 @@
+export const JsonRpcErrorCodes = {
+    ParseError: -32700,
+    InvalidRequest: -32600,
+    MethodNotFound: -32601,
+    InvalidParams: -32602,
+    InternalError: -32603,
+    ProviderNotFound: -32002,
+    SessionAlreadyExists: -32003,
+    UnsupportedProtocolVersion: -32005,
+    NotFound: -32008,
+    PermissionDenied: -32009,
+    AlreadyExists: -32010,
+    Conflict: -32011,
+};
+export class AhpServerError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.name = 'AhpServerError';
+        this.code = code;
+        this.data = data;
+    }
+    toJsonRpcError() {
+        return this.data === undefined
+            ? { code: this.code, message: this.message }
+            : { code: this.code, message: this.message, data: this.data };
+    }
+}
+export function toJsonRpcError(error) {
+    if (error instanceof AhpServerError) {
+        return error.toJsonRpcError();
+    }
+    if (error instanceof Error) {
+        return { code: JsonRpcErrorCodes.InternalError, message: error.message };
+    }
+    return { code: JsonRpcErrorCodes.InternalError, message: String(error) };
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,UAAU,EAAE,CAAC,KAAK;IAClB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,aAAa,EAAE,CAAC,KAAK;IACrB,aAAa,EAAE,CAAC,KAAK;IACrB,gBAAgB,EAAE,CAAC,KAAK;IACxB,oBAAoB,EAAE,CAAC,KAAK;IAC5B,0BAA0B,EAAE,CAAC,KAAK;IAClC,QAAQ,EAAE,CAAC,KAAK;IAChB,gBAAgB,EAAE,CAAC,KAAK;IACxB,aAAa,EAAE,CAAC,KAAK;IACrB,QAAQ,EAAE,CAAC,KAAK;CACR,CAAC;AAEX,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAS;IACb,IAAI,CAAW;IAExB,YAAY,IAAY,EAAE,OAAe,EAAE,IAAc;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS;YAC5B,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YAC5C,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAClE,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC,cAAc,EAAE,CAAC;IAChC,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC3E,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,9 @@
+export { AhpServer } from './server.js';
+export { ActiveClientToolRouter, MarkdownTurnEmitter, markdownPart, markdownPartId, resolveModelId, singleModelAgentInfo, stringOrMarkdown, uriToPath, } from './provider-kit.js';
+export { FileSystemSessionStore, InMemorySessionStore } from './store.js';
+export { InMemoryServerTransport, createInMemoryTransportPair, createInProcessAhpClientTransport, } from './transport/in-memory.js';
+export type { ActiveClientToolRouterInvocation, ActiveClientToolRouterOptions, SingleModelAgentInfoOptions, } from './provider-kit.js';
+export type { ActiveClientToolInvocation, ActiveClientTools, ActiveClientToolSink, AhpTransport, AgentProvider, AgentSession, AgentSessionContext, AgentTurnSink, AhpServerOptions, JsonRpcErrorResponse, JsonRpcMessage, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ServerTransport, SessionStore, TransportFrame, } from './types.js';
+export type { FileSystemSessionStoreOptions } from './store.js';
+export type { InProcessAhpClientTransport, ReusableAhpServer, } from './transport/in-memory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,gCAAgC,EAChC,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EACV,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,0BAA0B,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,5 @@
+export { AhpServer } from './server.js';
+export { ActiveClientToolRouter, MarkdownTurnEmitter, markdownPart, markdownPartId, resolveModelId, singleModelAgentInfo, stringOrMarkdown, uriToPath, } from './provider-kit.js';
+export { FileSystemSessionStore, InMemorySessionStore } from './store.js';
+export { InMemoryServerTransport, createInMemoryTransportPair, createInProcessAhpClientTransport, } from './transport/in-memory.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,0BAA0B,CAAC"}

package/dist/src/provider-kit.d.ts

@@ -0,0 +1,2 @@
+export * from '@wyrd-company/ahp-provider-kit';
+//# sourceMappingURL=provider-kit.d.ts.map

package/dist/src/provider-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-kit.d.ts","sourceRoot":"","sources":["../../src/provider-kit.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC"}

package/dist/src/provider-kit.js

@@ -0,0 +1,2 @@
+export * from '@wyrd-company/ahp-provider-kit';
+//# sourceMappingURL=provider-kit.js.map

package/dist/src/provider-kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-kit.js","sourceRoot":"","sources":["../../src/provider-kit.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC"}

package/dist/src/resources.d.ts

@@ -0,0 +1,22 @@
+import { type ResourceCopyParams, type ResourceCopyResult, type ResourceDeleteParams, type ResourceDeleteResult, type ResourceListParams, type ResourceListResult, type ResourceMkdirParams, type ResourceMkdirResult, type ResourceMoveParams, type ResourceMoveResult, type ResourceReadParams, type ResourceReadResult, type ResourceResolveParams, type ResourceResolveResult, type ResourceWriteParams, type ResourceWriteResult, type URI } from '@microsoft/agent-host-protocol';
+export interface FileResourceServiceOptions {
+    readonly roots?: readonly URI[];
+}
+export declare class FileResourceService {
+    private readonly roots;
+    constructor(options?: FileResourceServiceOptions);
+    read(params: ResourceReadParams): Promise<ResourceReadResult>;
+    write(params: ResourceWriteParams): Promise<ResourceWriteResult>;
+    list(params: ResourceListParams): Promise<ResourceListResult>;
+    copy(params: ResourceCopyParams): Promise<ResourceCopyResult>;
+    delete(params: ResourceDeleteParams): Promise<ResourceDeleteResult>;
+    move(params: ResourceMoveParams): Promise<ResourceMoveResult>;
+    resolve(params: ResourceResolveParams): Promise<ResourceResolveResult>;
+    mkdir(params: ResourceMkdirParams): Promise<ResourceMkdirResult>;
+    private resolveExisting;
+    private resolveWritable;
+    private assertNearestExistingParentAllowed;
+    private resolveAllowedPath;
+    private assertAllowedPath;
+}
+//# sourceMappingURL=resources.d.ts.map

package/dist/src/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/resources.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAE1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAExB,KAAK,GAAG,EACT,MAAM,gCAAgC,CAAC;AAIxC,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,EAAE,CAAC;CACjC;AAID,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;gBAErB,OAAO,GAAE,0BAA+B;IAK9C,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAW7D,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmChE,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAe7D,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAe7D,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAMnE,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAa7D,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAmBtE,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAcxD,eAAe;YAWf,eAAe;YAgBf,kCAAkC;IAgBhD,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,iBAAiB;CAO1B"}

package/dist/src/resources.js

@@ -0,0 +1,265 @@
+import { constants as fsConstants, copyFile, cp, lstat, mkdir, readdir, readFile, realpath, rename, rm, stat, writeFile, } from 'node:fs/promises';
+import { dirname, extname, isAbsolute, normalize, relative, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { AhpServerError, JsonRpcErrorCodes } from './errors.js';
+export class FileResourceService {
+    roots;
+    constructor(options = {}) {
+        const configuredRoots = options.roots?.length ? options.roots : [`file://${process.cwd()}`];
+        this.roots = configuredRoots.map(root => normalizePath(uriToPath(root)));
+    }
+    async read(params) {
+        const path = await this.resolveExisting(params.uri);
+        const data = await readFile(path);
+        const encoding = (params.encoding ?? 'utf-8');
+        return {
+            data: encoding === 'base64' ? data.toString('base64') : data.toString('utf8'),
+            encoding: encoding,
+            contentType: contentType(path, encoding),
+        };
+    }
+    async write(params) {
+        const path = await this.resolveWritable(params.uri);
+        const payload = decodeData(params.data, params.encoding);
+        const exists = await pathExists(path);
+        if (params.createOnly && exists) {
+            throw new AhpServerError(JsonRpcErrorCodes.AlreadyExists, `resource already exists: ${params.uri}`);
+        }
+        if (params.ifMatch) {
+            if (!exists) {
+                throw new AhpServerError(JsonRpcErrorCodes.Conflict, `resource etag does not match: ${params.uri}`);
+            }
+            const current = await stat(path);
+            if (etag(current) !== params.ifMatch) {
+                throw new AhpServerError(JsonRpcErrorCodes.Conflict, `resource etag does not match: ${params.uri}`);
+            }
+        }
+        let output;
+        const mode = params.mode ?? 'truncate';
+        const position = params.position ?? 0;
+        if (mode === 'truncate') {
+            const existing = exists ? await readFile(path) : Buffer.alloc(0);
+            output = Buffer.concat([existing.subarray(0, clamp(position, 0, existing.length)), payload]);
+        }
+        else {
+            const existing = exists ? await readFile(path) : Buffer.alloc(0);
+            const insertAt = mode === 'append'
+                ? clamp(existing.length - position, 0, existing.length)
+                : clamp(position, 0, existing.length);
+            output = Buffer.concat([existing.subarray(0, insertAt), payload, existing.subarray(insertAt)]);
+        }
+        await writeFile(path, output, { mode: 0o600 });
+        return {};
+    }
+    async list(params) {
+        const path = await this.resolveExisting(params.uri);
+        const entries = await readdir(path, { withFileTypes: true }).catch(error => {
+            throw mapFsError(error, `resource is not a directory: ${params.uri}`);
+        });
+        const result = entries
+            .filter(entry => entry.isFile() || entry.isDirectory())
+            .map(entry => ({
+            name: entry.name,
+            type: entry.isDirectory() ? 'directory' : 'file',
+        }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        return { entries: result };
+    }
+    async copy(params) {
+        const source = await this.resolveExisting(params.source);
+        const destination = await this.resolveWritable(params.destination);
+        if (params.failIfExists && await pathExists(destination)) {
+            throw new AhpServerError(JsonRpcErrorCodes.AlreadyExists, `resource already exists: ${params.destination}`);
+        }
+        const sourceStat = await stat(source);
+        if (sourceStat.isDirectory()) {
+            await cp(source, destination, { recursive: true, force: !params.failIfExists, errorOnExist: params.failIfExists });
+        }
+        else {
+            await copyFile(source, destination, params.failIfExists ? fsConstants.COPYFILE_EXCL : 0);
+        }
+        return {};
+    }
+    async delete(params) {
+        const path = await this.resolveExisting(params.uri);
+        await rm(path, { recursive: params.recursive ?? false });
+        return {};
+    }
+    async move(params) {
+        const source = await this.resolveExisting(params.source);
+        const destination = await this.resolveWritable(params.destination);
+        if (params.failIfExists && await pathExists(destination)) {
+            throw new AhpServerError(JsonRpcErrorCodes.AlreadyExists, `resource already exists: ${params.destination}`);
+        }
+        if (!params.failIfExists && await pathExists(destination)) {
+            await rm(destination, { recursive: true, force: true });
+        }
+        await rename(source, destination);
+        return {};
+    }
+    async resolve(params) {
+        const path = params.followSymlinks === false
+            ? this.resolveAllowedPath(params.uri)
+            : await this.resolveExisting(params.uri);
+        const stats = params.followSymlinks === false ? await lstat(path) : await stat(path);
+        if (params.followSymlinks === false && stats.isSymbolicLink()) {
+            this.assertAllowedPath(path);
+        }
+        return {
+            uri: pathToFileURL(path).href,
+            type: resourceType(stats),
+            ...(stats.isDirectory() ? {} : { size: stats.size }),
+            mtime: stats.mtime.toISOString(),
+            ctime: stats.ctime.toISOString(),
+            ...(stats.isFile() ? { contentType: contentType(path, 'base64') } : {}),
+            etag: etag(stats),
+        };
+    }
+    async mkdir(params) {
+        const path = this.resolveAllowedPath(params.uri);
+        await this.assertNearestExistingParentAllowed(path);
+        if (await pathExists(path)) {
+            const stats = await stat(path);
+            if (!stats.isDirectory()) {
+                throw new AhpServerError(JsonRpcErrorCodes.AlreadyExists, `resource already exists and is not a directory: ${params.uri}`);
+            }
+            return {};
+        }
+        await mkdir(path, { recursive: true, mode: 0o700 });
+        return {};
+    }
+    async resolveExisting(uri) {
+        const requested = this.resolveAllowedPath(uri);
+        try {
+            const canonical = await realpath(requested);
+            this.assertAllowedPath(canonical);
+            return canonical;
+        }
+        catch (error) {
+            throw mapFsError(error, `resource not found: ${uri}`);
+        }
+    }
+    async resolveWritable(uri) {
+        const requested = this.resolveAllowedPath(uri);
+        const parent = dirname(requested);
+        try {
+            const canonicalParent = await realpath(parent);
+            this.assertAllowedPath(canonicalParent);
+            if (await pathExists(requested)) {
+                const canonicalTarget = await realpath(requested);
+                this.assertAllowedPath(canonicalTarget);
+            }
+            return requested;
+        }
+        catch (error) {
+            throw mapFsError(error, `resource parent not found: ${uri}`);
+        }
+    }
+    async assertNearestExistingParentAllowed(path) {
+        let current = dirname(path);
+        while (true) {
+            if (await pathExists(current)) {
+                const canonical = await realpath(current);
+                this.assertAllowedPath(canonical);
+                return;
+            }
+            const parent = dirname(current);
+            if (parent === current) {
+                throw new AhpServerError(JsonRpcErrorCodes.NotFound, `resource parent not found: ${path}`);
+            }
+            current = parent;
+        }
+    }
+    resolveAllowedPath(uri) {
+        const path = normalizePath(uriToPath(uri));
+        this.assertAllowedPath(path);
+        return path;
+    }
+    assertAllowedPath(path) {
+        const normalized = normalizePath(path);
+        if (this.roots.some(root => normalized === root || relative(root, normalized).startsWith('..') === false && !isAbsolute(relative(root, normalized)))) {
+            return;
+        }
+        throw new AhpServerError(JsonRpcErrorCodes.PermissionDenied, `resource is outside allowed roots: ${path}`);
+    }
+}
+function uriToPath(uri) {
+    if (!uri.startsWith('file://')) {
+        throw new AhpServerError(JsonRpcErrorCodes.PermissionDenied, `unsupported resource URI scheme: ${uri}`);
+    }
+    return fileURLToPath(uri);
+}
+function normalizePath(path) {
+    return normalize(resolve(path));
+}
+function decodeData(data, encoding) {
+    if (encoding === 'base64') {
+        return Buffer.from(data, 'base64');
+    }
+    if (encoding === 'utf-8') {
+        return Buffer.from(data, 'utf8');
+    }
+    throw new AhpServerError(JsonRpcErrorCodes.InvalidParams, `unsupported resource encoding: ${encoding}`);
+}
+function contentType(path, encoding) {
+    const ext = extname(path).toLowerCase();
+    if (ext === '.json') {
+        return 'application/json';
+    }
+    if (ext === '.md') {
+        return 'text/markdown';
+    }
+    if (ext === '.txt' || encoding === 'utf-8') {
+        return 'text/plain';
+    }
+    return 'application/octet-stream';
+}
+function resourceType(stats) {
+    if (stats.isFile()) {
+        return 'file';
+    }
+    if (stats.isDirectory()) {
+        return 'directory';
+    }
+    if (stats.isSymbolicLink()) {
+        return 'symlink';
+    }
+    return 'file';
+}
+function etag(stats) {
+    return `W/"${stats.size}-${Math.trunc(stats.mtimeMs)}"`;
+}
+async function pathExists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT') {
+            return false;
+        }
+        throw error;
+    }
+}
+function mapFsError(error, fallback) {
+    if (!isNodeError(error)) {
+        return error instanceof Error ? error : new Error(String(error));
+    }
+    if (error.code === 'ENOENT' || error.code === 'ENOTDIR') {
+        return new AhpServerError(JsonRpcErrorCodes.NotFound, fallback);
+    }
+    if (error.code === 'EEXIST') {
+        return new AhpServerError(JsonRpcErrorCodes.AlreadyExists, fallback);
+    }
+    if (error.code === 'EACCES' || error.code === 'EPERM') {
+        return new AhpServerError(JsonRpcErrorCodes.PermissionDenied, fallback);
+    }
+    return new AhpServerError(JsonRpcErrorCodes.InternalError, error.message);
+}
+function isNodeError(error) {
+    return error instanceof Error && 'code' in error;
+}
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+//# sourceMappingURL=resources.js.map

package/dist/src/resources.js.map

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