@appport/sdk 1.0.1

package/node_modules/@appport/protocol/dist/jsonschema.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The wire-level schema representation for AppPort is JSON Schema
+ * (specification §32). This is a pragmatic subset of draft 2020-12 — enough to
+ * describe capability inputs and outputs in a language-neutral way, and enough
+ * for a generator in any language to consume.
+ */
+export interface JSONSchema {
+    $schema?: string;
+    $id?: string;
+    $ref?: string;
+    $defs?: Record<string, JSONSchema>;
+    title?: string;
+    description?: string;
+    type?: JSONSchemaType | JSONSchemaType[];
+    enum?: unknown[];
+    const?: unknown;
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    additionalProperties?: boolean | JSONSchema;
+    propertyNames?: JSONSchema;
+    items?: JSONSchema;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    anyOf?: JSONSchema[];
+    oneOf?: JSONSchema[];
+    allOf?: JSONSchema[];
+    not?: JSONSchema;
+    default?: unknown;
+    examples?: unknown[];
+    deprecated?: boolean;
+    /** Namespaced vendor annotations (`x-appport-*`). */
+    [key: `x-${string}`]: unknown;
+}
+export type JSONSchemaType = "null" | "boolean" | "object" | "array" | "number" | "integer" | "string";
+export declare const JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
+/** A schema that accepts any JSON value; used for capabilities without input. */
+export declare const ANY_SCHEMA: JSONSchema;
+/** The canonical empty-object schema (`input: {}`). */
+export declare const EMPTY_OBJECT_SCHEMA: JSONSchema;
+//# sourceMappingURL=jsonschema.d.ts.map

package/node_modules/@appport/protocol/dist/jsonschema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonschema.d.ts","sourceRoot":"","sources":["../src/jsonschema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IACzC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,aAAa,CAAC,EAAE,UAAU,CAAC;IAE3B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,UAAU,CAAC;IAEjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qDAAqD;IACrD,CAAC,GAAG,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvG,eAAO,MAAM,mBAAmB,iDAAiD,CAAC;AAElF,iFAAiF;AACjF,eAAO,MAAM,UAAU,EAAE,UAAe,CAAC;AAEzC,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,EAAE,UAA4E,CAAC"}

package/node_modules/@appport/protocol/dist/jsonschema.js

@@ -0,0 +1,6 @@
+export const JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
+/** A schema that accepts any JSON value; used for capabilities without input. */
+export const ANY_SCHEMA = {};
+/** The canonical empty-object schema (`input: {}`). */
+export const EMPTY_OBJECT_SCHEMA = { type: "object", properties: {}, additionalProperties: false };
+//# sourceMappingURL=jsonschema.js.map

package/node_modules/@appport/protocol/dist/jsonschema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonschema.js","sourceRoot":"","sources":["../src/jsonschema.ts"],"names":[],"mappings":"AAoDA,MAAM,CAAC,MAAM,mBAAmB,GAAG,8CAA8C,CAAC;AAElF,iFAAiF;AACjF,MAAM,CAAC,MAAM,UAAU,GAAe,EAAE,CAAC;AAEzC,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC"}

package/node_modules/@appport/protocol/dist/manifest.d.ts

@@ -0,0 +1,131 @@
+import type { JsonValue } from "./errors.js";
+import type { JSONSchema } from "./jsonschema.js";
+import type { ConformanceLevel, ProtocolId } from "./version.js";
+/**
+ * The application manifest (specification §30, §31, §40).
+ *
+ * The manifest is the language-neutral description of an AppPort application:
+ * what capabilities exist, what they accept and return, what permissions they
+ * require, what events they emit and which transports serve them.
+ */
+export interface AppPortManifest {
+    protocol: ProtocolId;
+    application: ApplicationDescriptor;
+    capabilities: CapabilityManifestEntry[];
+    events: EventManifestEntry[];
+    transports: TransportDescriptor[];
+    /** Highest conformance level this deployment implements (§76). */
+    conformance?: ConformanceLevel;
+    /** Namespaced protocol extensions advertised by this deployment (§71). */
+    extensions?: string[];
+    /** Non-sensitive deployment annotations. */
+    attributes?: Record<string, JsonValue>;
+}
+export interface ApplicationDescriptor {
+    /** Stable, recommended reverse-domain application identity (§41). */
+    id: string;
+    name: string;
+    /** Application (not protocol) version. */
+    version: string;
+    description?: string;
+    documentation?: string;
+}
+/** Concurrency declaration for a capability (specification §45). */
+export type ConcurrencyPolicy = {
+    mode: "parallel";
+} | {
+    mode: "serialized";
+} | {
+    mode: "keyed";
+    key: string;
+};
+export type IdempotencySupport = "supported" | "unsupported";
+/** How the capability answers: a single response, or a stream of values. */
+export type CapabilityKind = "request" | "stream";
+/**
+ * One version of a capability. Everything a client needs to call it correctly.
+ */
+export interface CapabilityVersionEntry {
+    version: number;
+    description?: string;
+    kind: CapabilityKind;
+    inputSchema: JSONSchema;
+    outputSchema: JSONSchema;
+    /** Permissions required to invoke this capability version (§34). */
+    authorization: string[];
+    idempotency?: IdempotencySupport;
+    concurrency?: ConcurrencyPolicy;
+    /** Server-side maximum request duration in milliseconds (§46). */
+    timeoutMs?: number;
+    deprecated?: boolean;
+    /** Events this capability version may emit (§17). */
+    emits?: string[];
+}
+/**
+ * A capability as published in the manifest. Top-level `inputSchema`,
+ * `outputSchema` and `authorization` mirror the newest non-deprecated version
+ * so simple consumers can read the entry directly; `definitions` carries every
+ * supported version.
+ */
+export interface CapabilityManifestEntry {
+    name: string;
+    versions: number[];
+    latestVersion: number;
+    description?: string;
+    kind: CapabilityKind;
+    inputSchema: JSONSchema;
+    outputSchema: JSONSchema;
+    authorization: string[];
+    idempotency?: IdempotencySupport;
+    concurrency?: ConcurrencyPolicy;
+    definitions: CapabilityVersionEntry[];
+}
+export interface EventVersionEntry {
+    version: number;
+    description?: string;
+    payloadSchema: JSONSchema;
+    /** Permissions a session must hold to observe this event. */
+    authorization: string[];
+    deprecated?: boolean;
+}
+export interface EventManifestEntry {
+    name: string;
+    versions: number[];
+    latestVersion: number;
+    description?: string;
+    payloadSchema: JSONSchema;
+    authorization: string[];
+    definitions: EventVersionEntry[];
+}
+/** Transport advertisement used for runtime discovery (§40). */
+export interface TransportDescriptor {
+    /** `http`, `websocket`, `ipc`, `inprocess`, `webtransport`, … */
+    kind: string;
+    /** Endpoint path or URL. Absent for transports without an address (IPC). */
+    endpoint?: string;
+    /** Optional IPC channel/command name, for desktop runtimes. */
+    channel?: string;
+    attributes?: Record<string, JsonValue>;
+}
+/** The `.well-known` discovery document (specification §39). */
+export interface DiscoveryDocument {
+    protocol: ProtocolId;
+    /** Path or URL of the manifest resource. */
+    manifest: string;
+    /** Path or URL of the request endpoint. */
+    endpoint: string;
+    application?: Pick<ApplicationDescriptor, "id" | "name" | "version">;
+    transports?: TransportDescriptor[];
+}
+export declare const WELL_KNOWN_PATH = "/.well-known/appport";
+export declare const DEFAULT_HTTP_ENDPOINT = "/appport";
+export declare const DEFAULT_WS_ENDPOINT = "/appport/ws";
+export declare const DEFAULT_MANIFEST_PATH = "/appport/manifest";
+/** Looks up a capability entry by name. */
+export declare function findCapability(manifest: AppPortManifest, name: string): CapabilityManifestEntry | undefined;
+/** Looks up one capability version. */
+export declare function findCapabilityVersion(manifest: AppPortManifest, name: string, version: number): CapabilityVersionEntry | undefined;
+export declare function findEvent(manifest: AppPortManifest, name: string): EventManifestEntry | undefined;
+/** True when the manifest advertises the named transport kind. */
+export declare function hasTransport(manifest: AppPortManifest, kind: string): boolean;
+//# sourceMappingURL=manifest.d.ts.map

package/node_modules/@appport/protocol/dist/manifest.d.ts.map

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

package/node_modules/@appport/protocol/dist/manifest.js

@@ -0,0 +1,20 @@
+export const WELL_KNOWN_PATH = "/.well-known/appport";
+export const DEFAULT_HTTP_ENDPOINT = "/appport";
+export const DEFAULT_WS_ENDPOINT = "/appport/ws";
+export const DEFAULT_MANIFEST_PATH = "/appport/manifest";
+/** Looks up a capability entry by name. */
+export function findCapability(manifest, name) {
+    return manifest.capabilities.find((entry) => entry.name === name);
+}
+/** Looks up one capability version. */
+export function findCapabilityVersion(manifest, name, version) {
+    return findCapability(manifest, name)?.definitions.find((entry) => entry.version === version);
+}
+export function findEvent(manifest, name) {
+    return manifest.events.find((entry) => entry.name === name);
+}
+/** True when the manifest advertises the named transport kind. */
+export function hasTransport(manifest, kind) {
+    return manifest.transports.some((transport) => transport.kind === kind);
+}
+//# sourceMappingURL=manifest.js.map

package/node_modules/@appport/protocol/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AA+HA,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AACtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAEzD,2CAA2C;AAC3C,MAAM,UAAU,cAAc,CAAC,QAAyB,EAAE,IAAY;IACpE,OAAO,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,qBAAqB,CACnC,QAAyB,EACzB,IAAY,EACZ,OAAe;IAEf,OAAO,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAyB,EAAE,IAAY;IAC/D,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,YAAY,CAAC,QAAyB,EAAE,IAAY;IAClE,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC1E,CAAC"}

package/node_modules/@appport/protocol/dist/names.d.ts

@@ -0,0 +1,26 @@
+/** Transport words that must never appear as a name segment. */
+export declare const RESERVED_NAME_SEGMENTS: readonly ["http", "https", "ws", "wss", "websocket", "webtransport", "ipc", "electron", "tauri", "rest", "grpc", "inprocess"];
+export interface NameValidation {
+    valid: boolean;
+    reason?: string;
+}
+export declare function validateName(name: unknown): NameValidation;
+export declare function isValidName(name: unknown): name is string;
+/** The namespace portion of a name (`documents` for `documents.save`). */
+export declare function namespaceOf(name: string): string;
+/** The operation portion of a name (`save` for `documents.save`). */
+export declare function operationOf(name: string): string;
+/** Renders the canonical `name@version` reference used in docs and tooling. */
+export declare function capabilityRef(name: string, version: number): string;
+/** Parses `documents.save@1`. Returns null when the reference is malformed. */
+export declare function parseCapabilityRef(ref: string): {
+    name: string;
+    version: number;
+} | null;
+export declare function isValidApplicationId(id: unknown): id is string;
+/**
+ * Permission identifiers used by the authorization model (specification §34),
+ * e.g. `documents.write`.
+ */
+export declare function isValidPermission(permission: unknown): permission is string;
+//# sourceMappingURL=names.d.ts.map

package/node_modules/@appport/protocol/dist/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AAQA,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,+HAazB,CAAC;AAIX,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAmB1D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAEzD;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOxF;AAQD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,IAAI,MAAM,CAE3E"}

package/node_modules/@appport/protocol/dist/names.js

@@ -0,0 +1,85 @@
+/**
+ * Capability and event naming rules (specification §8).
+ *
+ * A name is `<namespace>.<operation>`; lowercase ASCII letters, digits and
+ * `.` as the namespace separator. Names MUST NOT encode a transport.
+ */
+const NAME_PATTERN = /^[a-z][a-z0-9]*(\.[a-z][a-z0-9]*)+$/;
+/** Transport words that must never appear as a name segment. */
+export const RESERVED_NAME_SEGMENTS = [
+    "http",
+    "https",
+    "ws",
+    "wss",
+    "websocket",
+    "webtransport",
+    "ipc",
+    "electron",
+    "tauri",
+    "rest",
+    "grpc",
+    "inprocess"
+];
+const RESERVED = new Set(RESERVED_NAME_SEGMENTS);
+export function validateName(name) {
+    if (typeof name !== "string" || name.length === 0) {
+        return { valid: false, reason: "name must be a non-empty string" };
+    }
+    if (name.length > 128) {
+        return { valid: false, reason: "name must be at most 128 characters" };
+    }
+    if (!NAME_PATTERN.test(name)) {
+        return {
+            valid: false,
+            reason: "name must be lowercase <namespace>.<operation> using ASCII letters and digits"
+        };
+    }
+    for (const segment of name.split(".")) {
+        if (RESERVED.has(segment)) {
+            return { valid: false, reason: `name must not contain the transport segment "${segment}"` };
+        }
+    }
+    return { valid: true };
+}
+export function isValidName(name) {
+    return validateName(name).valid;
+}
+/** The namespace portion of a name (`documents` for `documents.save`). */
+export function namespaceOf(name) {
+    return name.slice(0, name.indexOf("."));
+}
+/** The operation portion of a name (`save` for `documents.save`). */
+export function operationOf(name) {
+    return name.slice(name.lastIndexOf(".") + 1);
+}
+/** Renders the canonical `name@version` reference used in docs and tooling. */
+export function capabilityRef(name, version) {
+    return `${name}@${version}`;
+}
+/** Parses `documents.save@1`. Returns null when the reference is malformed. */
+export function parseCapabilityRef(ref) {
+    const at = ref.lastIndexOf("@");
+    if (at === -1)
+        return null;
+    const name = ref.slice(0, at);
+    const version = Number(ref.slice(at + 1));
+    if (!isValidName(name) || !Number.isInteger(version) || version < 1)
+        return null;
+    return { name, version };
+}
+/**
+ * Application identity (specification §41). Recommended form is a
+ * reverse-domain identifier such as `com.example.sherpa`.
+ */
+const APPLICATION_ID = /^[a-z][a-z0-9]*(\.[a-z0-9][a-z0-9-]*)+$/;
+export function isValidApplicationId(id) {
+    return typeof id === "string" && id.length <= 190 && APPLICATION_ID.test(id);
+}
+/**
+ * Permission identifiers used by the authorization model (specification §34),
+ * e.g. `documents.write`.
+ */
+export function isValidPermission(permission) {
+    return typeof permission === "string" && NAME_PATTERN.test(permission);
+}
+//# sourceMappingURL=names.js.map

package/node_modules/@appport/protocol/dist/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,YAAY,GAAG,qCAAqC,CAAC;AAE3D,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,MAAM;IACN,OAAO;IACP,IAAI;IACJ,KAAK;IACL,WAAW;IACX,cAAc;IACd,KAAK;IACL,UAAU;IACV,OAAO;IACP,MAAM;IACN,MAAM;IACN,WAAW;CACH,CAAC;AAEX,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,sBAAsB,CAAC,CAAC;AAOzD,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,qCAAqC,EAAE,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,+EAA+E;SACxF,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,gDAAgD,OAAO,GAAG,EAAE,CAAC;QAC9F,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;AAClC,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAe;IACzD,OAAO,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,cAAc,GAAG,yCAAyC,CAAC;AAEjE,MAAM,UAAU,oBAAoB,CAAC,EAAW;IAC9C,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAmB;IACnD,OAAO,OAAO,UAAU,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACzE,CAAC"}

package/node_modules/@appport/protocol/dist/operations.d.ts

@@ -0,0 +1,34 @@
+import type { AppErrorObject, JsonValue } from "./errors.js";
+/**
+ * Long-running operations (specification §47).
+ *
+ * A capability that cannot complete inside a request/response exchange returns
+ * an {@link OperationRef} immediately; progress is observed through the
+ * `operations.*` capabilities rather than by holding a transport open.
+ */
+export type OperationStatus = "pending" | "running" | "succeeded" | "failed" | "cancelled";
+export interface OperationRef {
+    operationId: string;
+    status: OperationStatus;
+}
+export interface OperationRecord<Result = JsonValue> {
+    operationId: string;
+    /** The capability that started the operation, e.g. `build.start`. */
+    capability: string;
+    status: OperationStatus;
+    createdAt: string;
+    updatedAt: string;
+    /** 0..1 completion hint when the operation can estimate progress. */
+    progress?: number;
+    result?: Result;
+    error?: AppErrorObject;
+    /** Non-sensitive operation metadata. */
+    attributes?: Record<string, JsonValue>;
+}
+export declare const OPERATION_CAPABILITIES: {
+    readonly status: "operations.status";
+    readonly cancel: "operations.cancel";
+    readonly events: "operations.events";
+};
+export declare function isTerminalStatus(status: OperationStatus): boolean;
+//# sourceMappingURL=operations.d.ts.map

package/node_modules/@appport/protocol/dist/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE3F,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,SAAS;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAEjE"}

package/node_modules/@appport/protocol/dist/operations.js

@@ -0,0 +1,9 @@
+export const OPERATION_CAPABILITIES = {
+    status: "operations.status",
+    cancel: "operations.cancel",
+    events: "operations.events"
+};
+export function isTerminalStatus(status) {
+    return status === "succeeded" || status === "failed" || status === "cancelled";
+}
+//# sourceMappingURL=operations.js.map

package/node_modules/@appport/protocol/dist/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AA+BA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,mBAAmB;IAC3B,MAAM,EAAE,mBAAmB;IAC3B,MAAM,EAAE,mBAAmB;CACnB,CAAC;AAEX,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,CAAC;AACjF,CAAC"}

package/node_modules/@appport/protocol/dist/session.d.ts

@@ -0,0 +1,27 @@
+import type { JsonValue } from "./errors.js";
+/**
+ * The authenticated identity behind a request (specification §35).
+ *
+ * AppPort does not prescribe how a principal authenticated; it only represents
+ * the resulting identity.
+ */
+export interface Principal {
+    id: string;
+    type: "user" | "service" | "device" | "application";
+    /** Optional human-readable label for logs and tooling. Never a credential. */
+    displayName?: string;
+    attributes?: Record<string, JsonValue>;
+}
+/** A transport-neutral session (specification §36). */
+export interface Session {
+    id: string;
+    principal?: Principal;
+    applicationId: string;
+    createdAt: string;
+    expiresAt?: string;
+    /** Permissions granted to this session (§34). */
+    permissions?: string[];
+    attributes?: Record<string, JsonValue>;
+}
+export declare function isSessionExpired(session: Session, now?: number): boolean;
+//# sourceMappingURL=session.d.ts.map

package/node_modules/@appport/protocol/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC;IACpD,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACxC;AAED,uDAAuD;AACvD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACxC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAIpF"}

package/node_modules/@appport/protocol/dist/session.js

@@ -0,0 +1,7 @@
+export function isSessionExpired(session, now = Date.now()) {
+    if (!session.expiresAt)
+        return false;
+    const expiry = Date.parse(session.expiresAt);
+    return Number.isFinite(expiry) && expiry <= now;
+}
+//# sourceMappingURL=session.js.map

package/node_modules/@appport/protocol/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IACzE,IAAI,CAAC,OAAO,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,GAAG,CAAC;AAClD,CAAC"}

package/node_modules/@appport/protocol/dist/validate.d.ts

@@ -0,0 +1,37 @@
+import { type AppEnvelope, type ClientEnvelope, type ServerEnvelope } from "./envelopes.js";
+/**
+ * Best-effort extraction of a request identifier so that a malformed envelope
+ * can still be answered with a correlated error response.
+ */
+export declare function peekRequestId(value: unknown): string | undefined;
+/** Best-effort extraction of a trace identifier from an unvalidated envelope. */
+export declare function peekTraceId(value: unknown): string | undefined;
+/**
+ * Validates the protocol layer of an envelope arriving from a client
+ * (specification §49, step "protocol validation").
+ *
+ * Throws {@link AppPortError} with `INVALID_PROTOCOL`, `UNSUPPORTED_VERSION`
+ * or `INVALID_REQUEST`. Capability input is *not* validated here; that is the
+ * capability schema's job.
+ */
+export declare function parseClientEnvelope(value: unknown): ClientEnvelope;
+/**
+ * Validates the protocol layer of an envelope arriving from a server. Clients
+ * use this so that a broken or hostile server cannot corrupt client state.
+ */
+export declare function parseServerEnvelope(value: unknown): ServerEnvelope;
+/** Parses any envelope, client- or server-originated. */
+export declare function parseEnvelope(value: unknown): AppEnvelope;
+export interface DecodeOptions {
+    /** Maximum accepted payload size in bytes. Defaults to 4 MiB. */
+    maxBytes?: number;
+}
+export declare const DEFAULT_MAX_ENVELOPE_BYTES: number;
+/**
+ * Decodes a UTF-8 JSON payload into an unvalidated envelope value.
+ * Throws `PAYLOAD_TOO_LARGE` or `INVALID_REQUEST`.
+ */
+export declare function decodeEnvelopeText(text: string, options?: DecodeOptions): unknown;
+/** Serializes an envelope. The single protocol serialization boundary (§75). */
+export declare function encodeEnvelope(envelope: AppEnvelope): string;
+//# sourceMappingURL=validate.d.ts.map

package/node_modules/@appport/protocol/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAIhB,KAAK,cAAc,EAEnB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAsDxB;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIhE;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI9D;AA6DD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CA8DlE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAwFlE;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAQzD;AAED,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,0BAA0B,QAAkB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAcrF;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAE5D"}