@appport/sdk 1.1.19 → 1.1.20

package/vendor/@appport/core/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@appport/core",
+  "version": "1.0.0",
+  "private": true,
+  "description": "AppPort capability runtime: registry, dispatcher, events, streams, sessions.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rkendel1/appport.git",
+    "directory": "packages/core"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./public": {
+      "types": "./dist/public.d.ts",
+      "import": "./dist/public.js"
+    },
+    "./server-internal": {
+      "types": "./dist/server-internal.d.ts",
+      "import": "./dist/server-internal.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean"
+  },
+  "dependencies": {
+    "@appport/protocol": "1.0.0",
+    "@appport/schema": "1.0.0",
+    "@appport/authorization": "1.0.0"
+  },
+  "bundleDependencies": [
+    "@appport/protocol",
+    "@appport/schema",
+    "@appport/authorization"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "homepage": "https://github.com/rkendel1/appport#readme",
+  "bugs": {
+    "url": "https://github.com/rkendel1/appport/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}

package/vendor/@appport/mcp/README.md

@@ -0,0 +1,29 @@
+# @appport/mcp
+
+Expose AppPort capabilities as MCP tools.
+
+```ts
+import { createMcpBridge } from "@appport/mcp";
+
+const bridge = createMcpBridge(application, { session });
+
+bridge.listTools();
+await bridge.callTool("documents_save", { documentId, content });
+```
+
+The layering matters:
+
+```
+AI -> MCP -> AppPort -> application
+```
+
+AppPort does not compete with MCP; it is the application protocol underneath it.
+A capability that is already defined, validated, versioned and authorized becomes
+an agent tool without a second definition, and the agent's session decides what
+it may call. A tool call runs the same dispatch pipeline as any other request, so
+`INVALID_INPUT` and `FORBIDDEN` reach the agent as tool errors rather than as
+unexpected behaviour.
+
+Tool names map to capability names (`documents.save` becomes `documents_save`)
+and the tool's input schema is the capability's published JSON Schema. Stream
+capabilities and the reserved `appport.*` namespace are excluded by default.

package/vendor/@appport/mcp/dist/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * `@appport/mcp` — expose AppPort capabilities as MCP tools (§65).
+ *
+ * The layering matters: AI → MCP → AppPort → application. AppPort does not
+ * compete with MCP; it is the application protocol underneath it, so a
+ * capability that is already defined, validated and authorized becomes an agent
+ * tool without a second definition.
+ */
+import { type AppPortManifest, type CapabilityManifestEntry, type JSONSchema } from "../../protocol/dist/index.d.ts";
+import type { AppPortApplication, DispatchOptions } from "../../core/dist/index.d.ts";
+/** The subset of the MCP tool descriptor AppPort can fill in from a manifest. */
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    /** Non-standard annotation naming the capability this tool came from. */
+    _appport: {
+        capability: string;
+        version: number;
+        authorization: string[];
+        outputSchema: JSONSchema;
+    };
+}
+export interface McpContent {
+    type: "text";
+    text: string;
+}
+export interface McpToolResult {
+    content: McpContent[];
+    isError?: boolean;
+}
+export interface McpBridgeOptions {
+    /** Capability names to expose. Defaults to every request capability. */
+    include?: (entry: CapabilityManifestEntry) => boolean;
+    /** Prefix applied to generated tool names, e.g. `docs`. */
+    prefix?: string;
+    /** Expose the reserved `appport.*` capabilities. Defaults to false. */
+    includeBuiltins?: boolean;
+}
+/** MCP tool names are conventionally `[a-z0-9_-]`; capability names are dotted. */
+export declare function toToolName(capability: string, prefix?: string): string;
+export declare function fromToolName(tool: string, prefix?: string): string;
+/** Renders the manifest's request capabilities as MCP tool descriptors. */
+export declare function toMcpTools(manifest: AppPortManifest, options?: McpBridgeOptions): McpTool[];
+/**
+ * A minimal MCP server surface over an AppPort application.
+ *
+ * Wire `listTools` and `callTool` into an MCP server implementation; the
+ * dispatch pipeline — validation, authorization, telemetry — is unchanged, so
+ * an agent has exactly the access its session grants and no more.
+ */
+export interface McpBridge {
+    listTools(): McpTool[];
+    callTool(name: string, args: unknown): Promise<McpToolResult>;
+}
+export declare function createMcpBridge(application: AppPortApplication, dispatch?: DispatchOptions, options?: McpBridgeOptions): McpBridge;
+/** Turns an AppPort error into the text an agent should see. */
+export declare function describeError(error: unknown): string;
+//# sourceMappingURL=index.d.ts.map

package/vendor/@appport/mcp/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEzE,iFAAiF;AACjF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,yEAAyE;IACzE,QAAQ,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,UAAU,CAAA;KAAE,CAAC;CACtG;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC;IACtD,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,EAAE,CAmB/F;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,IAAI,OAAO,EAAE,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC/D;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,kBAAkB,EAC/B,QAAQ,GAAE,eAAoB,EAC9B,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAiCX;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD"}

package/vendor/@appport/mcp/dist/index.js

@@ -0,0 +1,70 @@
+/**
+ * `@appport/mcp` — expose AppPort capabilities as MCP tools (§65).
+ *
+ * The layering matters: AI → MCP → AppPort → application. AppPort does not
+ * compete with MCP; it is the application protocol underneath it, so a
+ * capability that is already defined, validated and authorized becomes an agent
+ * tool without a second definition.
+ */
+import { AppPortError, createRequest, newRequestId } from "../../protocol/dist/index.js";
+/** MCP tool names are conventionally `[a-z0-9_-]`; capability names are dotted. */
+export function toToolName(capability, prefix) {
+    const base = capability.replace(/\./g, "_");
+    return (prefix ? `${prefix}_${base}` : base).slice(0, 64);
+}
+export function fromToolName(tool, prefix) {
+    const withoutPrefix = prefix && tool.startsWith(`${prefix}_`) ? tool.slice(prefix.length + 1) : tool;
+    return withoutPrefix.replace(/_/g, ".");
+}
+/** Renders the manifest's request capabilities as MCP tool descriptors. */
+export function toMcpTools(manifest, options = {}) {
+    const includeBuiltins = options.includeBuiltins ?? false;
+    return manifest.capabilities
+        .filter((entry) => entry.kind === "request")
+        .filter((entry) => includeBuiltins || !entry.name.startsWith("appport."))
+        .filter((entry) => options.include?.(entry) ?? true)
+        .map((entry) => ({
+        name: toToolName(entry.name, options.prefix),
+        description: entry.description ??
+            `Invokes the ${entry.name} capability of ${manifest.application.name} (version ${entry.latestVersion}).`,
+        inputSchema: entry.inputSchema,
+        _appport: {
+            capability: entry.name,
+            version: entry.latestVersion,
+            authorization: entry.authorization,
+            outputSchema: entry.outputSchema
+        }
+    }));
+}
+export function createMcpBridge(application, dispatch = {}, options = {}) {
+    const tools = () => toMcpTools(application.manifest(), options);
+    return {
+        listTools: tools,
+        async callTool(name, args) {
+            const tool = tools().find((entry) => entry.name === name);
+            if (!tool) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Unknown tool: ${name}` }]
+                };
+            }
+            const response = await application.handleRequest(createRequest({
+                requestId: newRequestId(),
+                capability: { name: tool._appport.capability, version: tool._appport.version },
+                input: args ?? {}
+            }), { transport: "mcp", ...dispatch });
+            if (!response.ok) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `${response.error.code}: ${response.error.message}` }]
+                };
+            }
+            return { content: [{ type: "text", text: JSON.stringify(response.output, null, 2) }] };
+        }
+    };
+}
+/** Turns an AppPort error into the text an agent should see. */
+export function describeError(error) {
+    return AppPortError.is(error) ? `${error.code}: ${error.message}` : "INTERNAL_ERROR: the capability failed";
+}
+//# sourceMappingURL=index.js.map

package/vendor/@appport/mcp/dist/index.js.map

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

package/vendor/@appport/mcp/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@appport/mcp",
+  "version": "1.0.0",
+  "description": "Expose AppPort capabilities as MCP tools.",
+  "license": "Apache-2.0",
+  "repository": "github:rkendel1/appport",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean"
+  },
+  "dependencies": {
+    "@appport/protocol": "1.0.0",
+    "@appport/core": "1.0.0"
+  },
+  "private": true
+}

package/vendor/@appport/mobile/README.md

@@ -0,0 +1,10 @@
+# @appport/mobile
+
+The lifecycle-aware AppPort client for React Native and Expo. It uses platform `fetch` and `WebSocket`; no native module or Node polyfill is required.
+
+```ts
+import { AppPortMobile } from "@appport/mobile";
+
+const app = await AppPortMobile.connect({ url: "https://api.example.com" });
+await app.documents.save({ documentId: "doc_1", content: "mobile" });
+```

package/vendor/@appport/mobile/dist/index.d.ts

@@ -0,0 +1,66 @@
+import { type CallOptions, type TypedStream, type Unsubscribe } from "../../client/dist/index.d.ts";
+export type MobileConnectionState = "connecting" | "connected" | "reconnecting" | "disconnected" | "closed";
+export type MobileLifecycleState = "active" | "background" | "inactive" | "unknown" | "extension";
+export interface MobileLifecycle {
+    currentState?: MobileLifecycleState | null;
+    addEventListener(type: "change", listener: (state: MobileLifecycleState) => void): {
+        remove(): void;
+    };
+}
+export interface MobileStorage {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem?(key: string): Promise<void>;
+}
+export interface MobileConnectOptions {
+    url: string;
+    headers?: Record<string, string>;
+    fetch?: typeof globalThis.fetch;
+    WebSocket?: unknown;
+    lifecycle?: MobileLifecycle;
+    storage?: MobileStorage;
+    storageKey?: string;
+    sessionId?: string;
+    reconnect?: {
+        delaysMs?: readonly number[];
+    };
+}
+export interface MobileSession {
+    sessionId: string;
+    applicationId: string;
+    connectedAt: string;
+    transport: string;
+    state: MobileConnectionState;
+}
+export interface MobileCapability {
+    (input: unknown, options?: CallOptions): any;
+    readonly [namespace: string]: MobileCapability;
+}
+export type MobileAppPort = MobileAppPortClient & Record<string, MobileCapability>;
+export declare class MobileAppPortClient {
+    #private;
+    readonly connection: {
+        state: MobileConnectionState;
+    };
+    session: MobileSession | undefined;
+    private constructor();
+    static connect(options: MobileConnectOptions): Promise<MobileAppPort>;
+    static discover(options: Omit<MobileConnectOptions, "url"> & {
+        origin: string;
+    }): Promise<MobileAppPort>;
+    get manifest(): import("@appport/protocol").AppPortManifest | undefined;
+    onConnectionState(handler: (state: MobileConnectionState) => void): Unsubscribe;
+    readonly events: {
+        on: (name: string, handler: (payload: unknown, event: unknown) => void) => Promise<Unsubscribe>;
+    };
+    call<T = unknown>(name: string, input: unknown, options?: CallOptions): Promise<T>;
+    stream<T = unknown>(name: string, input: unknown, options?: CallOptions): TypedStream<T>;
+    reconnect(): Promise<void>;
+    setLifecycleState(state: MobileLifecycleState): Promise<void>;
+    close(): Promise<void>;
+}
+export declare const AppPortMobile: {
+    connect: typeof MobileAppPortClient.connect;
+    discover: typeof MobileAppPortClient.discover;
+};
+//# sourceMappingURL=index.d.ts.map

package/vendor/@appport/mobile/dist/index.d.ts.map

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

package/vendor/@appport/mobile/dist/index.js

@@ -0,0 +1,182 @@
+import { AppPort } from "../../client/dist/index.js";
+import { AppPortError } from "../../protocol/dist/index.js";
+export class MobileAppPortClient {
+    connection = { state: "disconnected" };
+    session;
+    #client;
+    #options;
+    #subscriptions = new Set();
+    #stateListeners = new Set();
+    #lifecycleRelease;
+    #closed = false;
+    #reconnecting;
+    constructor(options, client) {
+        this.#options = options;
+        this.#client = client;
+        const lifecycle = options.lifecycle;
+        if (lifecycle) {
+            const subscription = lifecycle.addEventListener("change", (state) => { void this.setLifecycleState(state); });
+            this.#lifecycleRelease = () => subscription.remove();
+        }
+    }
+    static async connect(options) {
+        validateOptions(options);
+        const sessionId = await resolveSessionId(options);
+        const client = await AppPort.discover({ origin: options.url, headers: options.headers, fetch: options.fetch, WebSocket: options.WebSocket, sessionId });
+        const mobile = new MobileAppPortClient(options, client);
+        mobile.#connected(sessionId);
+        return capabilitySurface(mobile);
+    }
+    static discover(options) {
+        return MobileAppPortClient.connect({ ...options, url: options.origin });
+    }
+    get manifest() { return this.#client.manifest; }
+    onConnectionState(handler) {
+        this.#stateListeners.add(handler);
+        return () => this.#stateListeners.delete(handler);
+    }
+    events = {
+        on: async (name, handler) => {
+            const entry = { name, handler };
+            entry.release = await this.#client.events.subscribe(name, handler);
+            this.#subscriptions.add(entry);
+            return () => { entry.release?.(); this.#subscriptions.delete(entry); };
+        }
+    };
+    async call(name, input, options) {
+        try {
+            return await this.#client.call(name, input, options);
+        }
+        catch (error) {
+            if (!retryable(error) || this.#closed)
+                throw error;
+            await this.reconnect();
+            return this.#client.call(name, input, options);
+        }
+    }
+    stream(name, input, options) {
+        const underlying = this.#client.stream(name, input, options);
+        const self = this;
+        return {
+            cancel: (reason) => underlying.cancel(reason),
+            async *[Symbol.asyncIterator]() {
+                try {
+                    yield* underlying;
+                }
+                catch (error) {
+                    if (retryable(error) && !self.#closed)
+                        void self.reconnect();
+                    throw error;
+                }
+            }
+        };
+    }
+    async reconnect() {
+        if (this.#closed)
+            throw new AppPortError("CANCELLED", "The mobile client is closed");
+        if (this.#reconnecting)
+            return this.#reconnecting;
+        this.#reconnecting = this.#reconnectLoop().finally(() => { this.#reconnecting = undefined; });
+        return this.#reconnecting;
+    }
+    async #reconnectLoop() {
+        this.#setState("reconnecting");
+        await this.#client.close().catch(() => undefined);
+        const delays = this.#options.reconnect?.delaysMs ?? [1_000, 2_000, 4_000, 8_000, 16_000, 30_000];
+        let last;
+        for (const delay of [0, ...delays]) {
+            if (this.#closed)
+                return;
+            if (delay)
+                await wait(delay);
+            try {
+                const sessionId = await resolveSessionId(this.#options);
+                this.#client = await AppPort.discover({ origin: this.#options.url, headers: this.#options.headers, fetch: this.#options.fetch, WebSocket: this.#options.WebSocket, sessionId });
+                for (const entry of this.#subscriptions)
+                    entry.release = await this.#client.events.subscribe(entry.name, entry.handler);
+                this.#connected(sessionId);
+                return;
+            }
+            catch (error) {
+                last = error;
+            }
+        }
+        this.#setState("disconnected");
+        throw new AppPortError("INTERNAL_ERROR", "Mobile reconnect attempts were exhausted", { retryable: true, cause: last });
+    }
+    async setLifecycleState(state) {
+        if (state === "active") {
+            if (!this.#closed && this.connection.state !== "connected")
+                await this.reconnect();
+            return;
+        }
+        if (state === "background" || state === "inactive") {
+            await this.#client.close();
+            this.#setState("disconnected");
+        }
+    }
+    async close() {
+        this.#closed = true;
+        this.#lifecycleRelease?.();
+        for (const entry of this.#subscriptions)
+            entry.release?.();
+        this.#subscriptions.clear();
+        await this.#client.close();
+        this.#setState("closed");
+    }
+    #connected(sessionId) {
+        this.#setState("connected");
+        this.session = { sessionId, applicationId: this.#client.manifest.application.id, connectedAt: new Date().toISOString(), transport: this.#client.transport.kind, state: "connected" };
+    }
+    #setState(state) {
+        this.connection.state = state;
+        if (this.session)
+            this.session.state = state;
+        for (const listener of this.#stateListeners)
+            listener(state);
+    }
+}
+function capabilitySurface(client) {
+    return new Proxy(client, {
+        get(target, property, receiver) {
+            // An async factory resolves its return value as a thenable. Capability
+            // namespaces must never synthesize a `then` property.
+            if (property === "then")
+                return undefined;
+            if (typeof property !== "string" || property in target) {
+                const value = Reflect.get(target, property, receiver);
+                return typeof value === "function" ? value.bind(target) : value;
+            }
+            return capabilityProxy(target, [property]);
+        }
+    });
+}
+function capabilityProxy(client, path) {
+    const invoke = (input, options) => {
+        const name = path.join(".");
+        return client.manifest?.capabilities.find((entry) => entry.name === name)?.kind === "stream" ? client.stream(name, input, options) : client.call(name, input, options);
+    };
+    return new Proxy(invoke, { get: (_target, property) => typeof property === "string" ? capabilityProxy(client, [...path, property]) : undefined, apply: (_target, _this, args) => invoke(args[0], args[1]) });
+}
+function validateOptions(options) {
+    const url = new URL(options.url);
+    if (url.protocol !== "https:" && url.protocol !== "http:")
+        throw new AppPortError("INVALID_REQUEST", "Mobile AppPort URLs must use http or https");
+}
+async function resolveSessionId(options, replace = false) {
+    if (options.sessionId && !replace)
+        return options.sessionId;
+    const key = options.storageKey ?? "appport.mobile.session";
+    if (!replace) {
+        const stored = await options.storage?.getItem(key);
+        if (stored)
+            return stored;
+    }
+    const id = `ses_${globalThis.crypto?.randomUUID?.().replaceAll("-", "") ?? Math.random().toString(36).slice(2)}`;
+    await options.storage?.setItem(key, id);
+    return id;
+}
+const retryable = (error) => error instanceof AppPortError && (error.retryable || error.code === "STREAM_ERROR" || error.code === "INTERNAL_ERROR");
+const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export const AppPortMobile = { connect: MobileAppPortClient.connect, discover: MobileAppPortClient.discover };
+//# sourceMappingURL=index.js.map

package/vendor/@appport/mobile/dist/index.js.map

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

package/vendor/@appport/mobile/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@appport/mobile",
+  "version": "1.0.0",
+  "description": "Lifecycle-aware AppPort client for React Native, Expo, iOS and Android.",
+  "license": "Apache-2.0",
+  "repository": "github:rkendel1/appport",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "react-native": "./dist/index.js",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "react-native": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean"
+  },
+  "dependencies": {
+    "@appport/client": "1.0.0",
+    "@appport/protocol": "1.0.0"
+  },
+  "private": true
+}

package/vendor/@appport/protocol/README.md

@@ -0,0 +1,41 @@
+# @appport/protocol
+
+The AppPort wire contract: envelope types, error codes, naming rules, manifest
+shapes, structural validation and compatibility analysis.
+
+This package is pure. It has no runtime dependencies and knows nothing about
+transports, servers or clients — which is what makes it safe to depend on from
+a browser bundle, an Electron preload script or a CLI.
+
+```ts
+import { createRequest, parseClientEnvelope, PROTOCOL_ID } from "@appport/protocol";
+
+const request = createRequest({
+  requestId: "req_01J...",
+  capability: { name: "documents.save", version: 1 },
+  input: { documentId: "doc_1", content: "hello" }
+});
+
+parseClientEnvelope(request); // throws AppPortError on a malformed envelope
+```
+
+## What is here
+
+| Module           | Contents                                                        |
+| ---------------- | --------------------------------------------------------------- |
+| `version`        | `appport/1`, conformance levels                                  |
+| `envelopes`      | request, response, event, subscribe, stream envelopes and guards |
+| `validate`       | protocol-level structural validation, decode and encode          |
+| `errors`         | the standard error codes and `AppPortError`                      |
+| `names`          | capability, event, permission and application-id grammar         |
+| `ids`            | ULID-based identifier helpers                                    |
+| `manifest`       | manifest, discovery and transport descriptor types               |
+| `jsonschema`     | the JSON Schema subset published in manifests                    |
+| `session`        | `Principal` and `Session`                                        |
+| `operations`     | long-running operation records                                   |
+| `blob`           | binary references                                                |
+| `compatibility`  | breaking vs non-breaking manifest diffing                        |
+
+Names are checked, not merely typed: `electron.documents.save` and
+`ipc.saveDocument` are rejected, because a capability name that encodes a
+transport breaks the protocol's central invariant.