@harapter/core 0.1.1

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AA6BA;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IACvB,SAAS,CAAU;IACnB,UAAU,CAAyB;IACnC,SAAS,CAAwB;IACjC,YAAY,CAAqB;IACjC,OAAO,CAAgD;IAEhE;;;;OAIG;IACH,YACE,IAAsB,EACtB,OAAe,EACf,OAA4B;QAE5B,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC"}

package/dist/extensions.d.ts

@@ -0,0 +1,29 @@
+import type { ProviderExtensionDescriptor, ProviderExtensionRegistry } from './contracts.js';
+import type { ProviderId } from './identifiers.js';
+/** Mutable Adapter-side registry exposed to callers through read-only lookup. */
+export declare class ExtensionRegistry implements ProviderExtensionRegistry {
+    private readonly ownerProviderId;
+    private readonly entries;
+    /** @param ownerProviderId - Provider allowed to register entries. */
+    constructor(ownerProviderId: ProviderId);
+    /**
+     * Register one typed extension until its disposer runs.
+     * @param descriptor - Provider-owned discoverable metadata.
+     * @param value - Typed extension implementation.
+     * @returns Idempotent disposer for this exact registration.
+     */
+    register(descriptor: ProviderExtensionDescriptor, value: unknown): () => void;
+    /** @returns Detached descriptors in registration order. */
+    list(): readonly ProviderExtensionDescriptor[];
+    /**
+     * @param name - Provider-namespaced extension name.
+     * @returns Whether the extension is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * @param name - Provider-namespaced extension name.
+     * @returns The registered typed implementation, if present.
+     */
+    get<T>(name: string, guard?: (value: unknown) => value is T): T | undefined;
+}
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAOnD,iFAAiF;AACjF,qBAAa,iBAAkB,YAAW,yBAAyB;IAIrD,OAAO,CAAC,QAAQ,CAAC,eAAe;IAH5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAE7D,qEAAqE;gBACxC,eAAe,EAAE,UAAU;IAExD;;;;;OAKG;IACH,QAAQ,CACN,UAAU,EAAE,2BAA2B,EACvC,KAAK,EAAE,OAAO,GACb,MAAM,IAAI;IA4Bb,2DAA2D;IAC3D,IAAI,IAAI,SAAS,2BAA2B,EAAE;IAM9C;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS;CAO5E"}

package/dist/extensions.js

@@ -0,0 +1,59 @@
+import { HarnessError } from './errors.js';
+/** Mutable Adapter-side registry exposed to callers through read-only lookup. */
+export class ExtensionRegistry {
+    ownerProviderId;
+    entries = new Map();
+    /** @param ownerProviderId - Provider allowed to register entries. */
+    constructor(ownerProviderId) {
+        this.ownerProviderId = ownerProviderId;
+    }
+    /**
+     * Register one typed extension until its disposer runs.
+     * @param descriptor - Provider-owned discoverable metadata.
+     * @param value - Typed extension implementation.
+     * @returns Idempotent disposer for this exact registration.
+     */
+    register(descriptor, value) {
+        if (descriptor.providerId !== this.ownerProviderId) {
+            throw new HarnessError('invalid_request', 'Extension Provider does not match its registry owner.', { retryable: false, providerId: this.ownerProviderId });
+        }
+        if (this.entries.has(descriptor.name)) {
+            throw new HarnessError('invalid_request', `Extension ${descriptor.name} is already registered.`, { retryable: false, providerId: this.ownerProviderId });
+        }
+        const entry = {
+            descriptor: { ...descriptor },
+            value,
+        };
+        this.entries.set(descriptor.name, entry);
+        return () => {
+            if (this.entries.get(descriptor.name) === entry) {
+                this.entries.delete(descriptor.name);
+            }
+        };
+    }
+    /** @returns Detached descriptors in registration order. */
+    list() {
+        return [...this.entries.values()].map(({ descriptor }) => ({
+            ...descriptor,
+        }));
+    }
+    /**
+     * @param name - Provider-namespaced extension name.
+     * @returns Whether the extension is registered.
+     */
+    has(name) {
+        return this.entries.has(name);
+    }
+    /**
+     * @param name - Provider-namespaced extension name.
+     * @returns The registered typed implementation, if present.
+     */
+    get(name, guard) {
+        const value = this.entries.get(name)?.value;
+        if (value === undefined || (guard !== undefined && !guard(value))) {
+            return undefined;
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=extensions.js.map

package/dist/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C,iFAAiF;AACjF,MAAM,OAAO,iBAAiB;IAIC;IAHZ,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE7D,qEAAqE;IACrE,YAA6B,eAA2B;QAA3B,oBAAe,GAAf,eAAe,CAAY;IAAG,CAAC;IAE5D;;;;;OAKG;IACH,QAAQ,CACN,UAAuC,EACvC,KAAc;QAEd,IAAI,UAAU,CAAC,UAAU,KAAK,IAAI,CAAC,eAAe,EAAE,CAAC;YACnD,MAAM,IAAI,YAAY,CACpB,iBAAiB,EACjB,uDAAuD,EACvD,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,CACvD,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,YAAY,CACpB,iBAAiB,EACjB,aAAa,UAAU,CAAC,IAAI,yBAAyB,EACrD,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,CACvD,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAmB;YAC5B,UAAU,EAAE,EAAE,GAAG,UAAU,EAAE;YAC7B,KAAK;SACN,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzC,OAAO,GAAG,EAAE;YACV,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;gBAChD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;YACzD,GAAG,UAAU;SACd,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,GAAG,CAAI,IAAY,EAAE,KAAsC;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;QAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAClE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/identifiers.d.ts

@@ -0,0 +1,38 @@
+declare const opaqueIdentifier: unique symbol;
+type OpaqueIdentifier<Name extends string> = string & {
+    readonly [opaqueIdentifier]: Name;
+};
+/** Stable identifier for a dynamically registered Provider Adapter. */
+export type ProviderId = OpaqueIdentifier<'ProviderId'>;
+/** Stable host-scoped identifier for one connection profile. */
+export type ProfileId = OpaqueIdentifier<'ProfileId'>;
+/** Opaque Provider-owned session identifier. */
+export type ProviderSessionId = OpaqueIdentifier<'ProviderSessionId'>;
+/** Client-scoped identifier for one portable run. */
+export type RunId = OpaqueIdentifier<'RunId'>;
+/**
+ * Validate and brand a Provider identifier without assigning meaning to it.
+ * @param value - Dynamic Provider identifier.
+ * @returns The unchanged opaque identifier.
+ */
+export declare function providerId(value: string): ProviderId;
+/**
+ * Validate and brand a Profile identifier.
+ * @param value - Host-scoped Profile identifier.
+ * @returns The unchanged opaque identifier.
+ */
+export declare function profileId(value: string): ProfileId;
+/**
+ * Validate and brand an opaque Provider session identifier.
+ * @param value - Provider-native identifier.
+ * @returns The unchanged opaque identifier.
+ */
+export declare function providerSessionId(value: string): ProviderSessionId;
+/**
+ * Validate and brand a client-scoped run identifier.
+ * @param value - Run identifier.
+ * @returns The unchanged opaque identifier.
+ */
+export declare function runId(value: string): RunId;
+export {};
+//# sourceMappingURL=identifiers.d.ts.map

package/dist/identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../src/identifiers.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,gBAAgB,EAAE,OAAO,MAAM,CAAC;AAE9C,KAAK,gBAAgB,CAAC,IAAI,SAAS,MAAM,IAAI,MAAM,GAAG;IACpD,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC;CACnC,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;AAExD,gEAAgE;AAChE,MAAM,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;AAEtD,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;AAEtE,qDAAqD;AACrD,MAAM,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAU9C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAGpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAG1C"}

package/dist/identifiers.js

@@ -0,0 +1,45 @@
+import { HarnessError } from './errors.js';
+function validateIdentifier(value, label) {
+    if (value.length === 0 || value.trim() !== value) {
+        throw new HarnessError('invalid_request', `${label} is invalid.`, {
+            retryable: false,
+        });
+    }
+}
+/**
+ * Validate and brand a Provider identifier without assigning meaning to it.
+ * @param value - Dynamic Provider identifier.
+ * @returns The unchanged opaque identifier.
+ */
+export function providerId(value) {
+    validateIdentifier(value, 'providerId');
+    return value;
+}
+/**
+ * Validate and brand a Profile identifier.
+ * @param value - Host-scoped Profile identifier.
+ * @returns The unchanged opaque identifier.
+ */
+export function profileId(value) {
+    validateIdentifier(value, 'profileId');
+    return value;
+}
+/**
+ * Validate and brand an opaque Provider session identifier.
+ * @param value - Provider-native identifier.
+ * @returns The unchanged opaque identifier.
+ */
+export function providerSessionId(value) {
+    validateIdentifier(value, 'providerSessionId');
+    return value;
+}
+/**
+ * Validate and brand a client-scoped run identifier.
+ * @param value - Run identifier.
+ * @returns The unchanged opaque identifier.
+ */
+export function runId(value) {
+    validateIdentifier(value, 'runId');
+    return value;
+}
+//# sourceMappingURL=identifiers.js.map

package/dist/identifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.js","sourceRoot":"","sources":["../src/identifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoB3C,SAAS,kBAAkB,CAAC,KAAa,EAAE,KAAa;IACtD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;QACjD,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,GAAG,KAAK,cAAc,EAAE;YAChE,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,kBAAkB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACxC,OAAO,KAAmB,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACvC,OAAO,KAAkB,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IAC/C,OAAO,KAA0B,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,KAAc,CAAC;AACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { CancelResult, CapabilityManifest, CapabilityMode, CapabilityProbeOptions, CapabilityRequirement, CapabilityStatus, ClientDescriptor, CompatibilityWarning, ConnectionKind, CreateSessionInput, HarnessClient, HarnessEvent, HarnessEventType, HarnessInput, HarnessProfile, HarnessRun, HarnessSession, InputPart, InteractionRequest, InteractionResponse, ModelSelection, ProviderAdapterFactory, ProviderConnection, ProviderDescriptor, ProviderExtensionDescriptor, ProviderExtensionRegistry, RunOptions, RunRef, RunResult, SecretRef, SessionRef, UsageSummary, WorkspaceRef, } from './contracts.js';
+export { HarnessError, isHarnessError, type HarnessErrorCode, type HarnessErrorOptions, } from './errors.js';
+export { ExtensionRegistry } from './extensions.js';
+export { profileId, providerId, providerSessionId, runId, type ProfileId, type ProviderId, type ProviderSessionId, type RunId, } from './identifiers.js';
+export { assertSessionCompatibility, assertSessionOwnership, } from './ownership.js';
+export { HarnessRegistry } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,yBAAyB,EACzB,UAAU,EACV,MAAM,EACN,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EACL,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,KAAK,EACL,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,KAAK,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { HarnessError, isHarnessError, } from './errors.js';
+export { ExtensionRegistry } from './extensions.js';
+export { profileId, providerId, providerSessionId, runId, } from './identifiers.js';
+export { assertSessionCompatibility, assertSessionOwnership, } from './ownership.js';
+export { HarnessRegistry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmCA,OAAO,EACL,YAAY,EACZ,cAAc,GAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EACL,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,KAAK,GAKN,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/ownership.d.ts

@@ -0,0 +1,18 @@
+import type { SessionRef } from './contracts.js';
+import type { ProfileId, ProviderId } from './identifiers.js';
+/**
+ * Refuse a Session reference that is not owned by the active Provider/Profile.
+ * Adapters call this before sending any resume traffic.
+ * @param ref - Opaque Session reference supplied by a host.
+ * @param expectedProviderId - Active Adapter identity.
+ * @param expectedProfileId - Active Profile identity.
+ */
+export declare function assertSessionOwnership(ref: SessionRef, expectedProviderId: ProviderId, expectedProfileId: ProfileId): void;
+/**
+ * Refuse a Session reference created under another runtime compatibility
+ * identity. Adapters call this when they emit a compatibility reference.
+ * @param ref - Opaque Session reference supplied by a host.
+ * @param expectedCompatibilityRef - Active runtime or protocol fingerprint.
+ */
+export declare function assertSessionCompatibility(ref: SessionRef, expectedCompatibilityRef: string): void;
+//# sourceMappingURL=ownership.d.ts.map

package/dist/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../src/ownership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,UAAU,EACf,kBAAkB,EAAE,UAAU,EAC9B,iBAAiB,EAAE,SAAS,GAC3B,IAAI,CAeN;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,UAAU,EACf,wBAAwB,EAAE,MAAM,GAC/B,IAAI,CAYN"}

package/dist/ownership.js

@@ -0,0 +1,34 @@
+import { HarnessError } from './errors.js';
+/**
+ * Refuse a Session reference that is not owned by the active Provider/Profile.
+ * Adapters call this before sending any resume traffic.
+ * @param ref - Opaque Session reference supplied by a host.
+ * @param expectedProviderId - Active Adapter identity.
+ * @param expectedProfileId - Active Profile identity.
+ */
+export function assertSessionOwnership(ref, expectedProviderId, expectedProfileId) {
+    if (ref.providerId !== expectedProviderId ||
+        ref.profileId !== expectedProfileId) {
+        throw new HarnessError('session_provider_mismatch', 'Session reference is not owned by the active Provider and Profile.', {
+            retryable: false,
+            providerId: expectedProviderId,
+            profileId: expectedProfileId,
+        });
+    }
+}
+/**
+ * Refuse a Session reference created under another runtime compatibility
+ * identity. Adapters call this when they emit a compatibility reference.
+ * @param ref - Opaque Session reference supplied by a host.
+ * @param expectedCompatibilityRef - Active runtime or protocol fingerprint.
+ */
+export function assertSessionCompatibility(ref, expectedCompatibilityRef) {
+    if (ref.compatibilityRef !== expectedCompatibilityRef) {
+        throw new HarnessError('session_provider_mismatch', 'Session reference is not compatible with the active runtime.', {
+            retryable: false,
+            providerId: ref.providerId,
+            profileId: ref.profileId,
+        });
+    }
+}
+//# sourceMappingURL=ownership.js.map

package/dist/ownership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.js","sourceRoot":"","sources":["../src/ownership.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAe,EACf,kBAA8B,EAC9B,iBAA4B;IAE5B,IACE,GAAG,CAAC,UAAU,KAAK,kBAAkB;QACrC,GAAG,CAAC,SAAS,KAAK,iBAAiB,EACnC,CAAC;QACD,MAAM,IAAI,YAAY,CACpB,2BAA2B,EAC3B,oEAAoE,EACpE;YACE,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,kBAAkB;YAC9B,SAAS,EAAE,iBAAiB;SAC7B,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAe,EACf,wBAAgC;IAEhC,IAAI,GAAG,CAAC,gBAAgB,KAAK,wBAAwB,EAAE,CAAC;QACtD,MAAM,IAAI,YAAY,CACpB,2BAA2B,EAC3B,8DAA8D,EAC9D;YACE,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,27 @@
+import type { HarnessClient, HarnessProfile, ProviderAdapterFactory, ProviderDescriptor } from './contracts.js';
+import type { ProviderId } from './identifiers.js';
+/** Dynamic Provider Adapter registry with Profile and capability validation. */
+export declare class HarnessRegistry {
+    private readonly entries;
+    /**
+     * Register one Provider Adapter factory.
+     * @param factory - Independently versioned Adapter factory.
+     */
+    register(factory: ProviderAdapterFactory): void;
+    /** @param providerId - Dynamic Provider identifier to remove. */
+    unregister(providerId: ProviderId): void;
+    /** @returns Detached descriptors in registration order. */
+    listProviders(): readonly ProviderDescriptor[];
+    /**
+     * @param providerId - Dynamic Provider identifier.
+     * @returns A detached descriptor when registered.
+     */
+    getProvider(providerId: ProviderId): ProviderDescriptor | undefined;
+    /**
+     * Connect a Profile and reject inconsistent identity or required capabilities.
+     * @param profile - Host-owned connection configuration.
+     * @returns A validated active Client.
+     */
+    connect(profile: HarnessProfile): Promise<HarnessClient>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAOnD,gFAAgF;AAChF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAEhE;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAa/C,iEAAiE;IACjE,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIxC,2DAA2D;IAC3D,aAAa,IAAI,SAAS,kBAAkB,EAAE;IAM9C;;;OAGG;IACH,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,kBAAkB,GAAG,SAAS;IAKnE;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAoH/D"}

package/dist/registry.js

@@ -0,0 +1,234 @@
+import { HarnessError, isHarnessError } from './errors.js';
+/** Dynamic Provider Adapter registry with Profile and capability validation. */
+export class HarnessRegistry {
+    entries = new Map();
+    /**
+     * Register one Provider Adapter factory.
+     * @param factory - Independently versioned Adapter factory.
+     */
+    register(factory) {
+        const descriptor = cloneDescriptor(factory.descriptor());
+        validateDescriptor(descriptor);
+        if (this.entries.has(descriptor.providerId)) {
+            throw new HarnessError('invalid_request', `Provider ${descriptor.providerId} is already registered.`, { retryable: false, providerId: descriptor.providerId });
+        }
+        this.entries.set(descriptor.providerId, { descriptor, factory });
+    }
+    /** @param providerId - Dynamic Provider identifier to remove. */
+    unregister(providerId) {
+        this.entries.delete(providerId);
+    }
+    /** @returns Detached descriptors in registration order. */
+    listProviders() {
+        return [...this.entries.values()].map(({ descriptor }) => cloneDescriptor(descriptor));
+    }
+    /**
+     * @param providerId - Dynamic Provider identifier.
+     * @returns A detached descriptor when registered.
+     */
+    getProvider(providerId) {
+        const descriptor = this.entries.get(providerId)?.descriptor;
+        return descriptor === undefined ? undefined : cloneDescriptor(descriptor);
+    }
+    /**
+     * Connect a Profile and reject inconsistent identity or required capabilities.
+     * @param profile - Host-owned connection configuration.
+     * @returns A validated active Client.
+     */
+    async connect(profile) {
+        const requestedProfile = cloneProfile(profile);
+        validateProfile(requestedProfile);
+        const entry = this.entries.get(requestedProfile.providerId);
+        if (entry === undefined) {
+            throw new HarnessError('provider_not_found', `Provider ${requestedProfile.providerId} is not registered.`, {
+                retryable: false,
+                providerId: requestedProfile.providerId,
+                profileId: requestedProfile.profileId,
+            });
+        }
+        if (!entry.descriptor.connectionKinds.includes(requestedProfile.connection.kind)) {
+            throw new HarnessError('profile_invalid', `Provider ${requestedProfile.providerId} does not accept ${requestedProfile.connection.kind} connections.`, {
+                retryable: false,
+                providerId: requestedProfile.providerId,
+                profileId: requestedProfile.profileId,
+            });
+        }
+        let client;
+        try {
+            client = await entry.factory.connect(cloneProfile(requestedProfile));
+        }
+        catch (error) {
+            if (isHarnessError(error))
+                throw error;
+            throw new HarnessError('connection_failed', 'Provider connection failed before a Client became available.', {
+                retryable: true,
+                providerId: requestedProfile.providerId,
+                profileId: requestedProfile.profileId,
+            });
+        }
+        const clientDescriptor = await probeConnectedClient(client, requestedProfile, 'descriptor', () => client.descriptor());
+        if (!isRecord(clientDescriptor) ||
+            clientDescriptor['providerId'] !== requestedProfile.providerId ||
+            clientDescriptor['profileId'] !== requestedProfile.profileId ||
+            clientDescriptor['connectionKind'] !== requestedProfile.connection.kind) {
+            return rejectConnectedClient(client, new HarnessError('provider_api_incompatible', 'Connected Client identity does not match the requested Profile.', {
+                retryable: false,
+                providerId: requestedProfile.providerId,
+                profileId: requestedProfile.profileId,
+            }));
+        }
+        const manifest = await probeConnectedClient(client, requestedProfile, 'capabilities', () => client.capabilities());
+        if (!isCapabilityManifest(manifest) ||
+            manifest.providerId !== requestedProfile.providerId ||
+            manifest.profileId !== requestedProfile.profileId) {
+            return rejectConnectedClient(client, new HarnessError('provider_api_incompatible', 'Capability identity does not match the requested Profile.', {
+                retryable: false,
+                providerId: requestedProfile.providerId,
+                profileId: requestedProfile.profileId,
+            }));
+        }
+        const unmet = findUnmetCapability(manifest, requestedProfile);
+        if (unmet !== undefined) {
+            return rejectConnectedClient(client, new HarnessError('unsupported_capability', `Required capability ${unmet} is unavailable.`, {
+                retryable: false,
+                providerId: requestedProfile.providerId,
+                profileId: requestedProfile.profileId,
+                details: { capability: unmet },
+            }));
+        }
+        return client;
+    }
+}
+function cloneProfile(profile) {
+    return {
+        profileId: profile.profileId,
+        displayName: profile.displayName,
+        providerId: profile.providerId,
+        connection: cloneConnection(profile.connection),
+        ...(profile.providerOptions === undefined
+            ? {}
+            : { providerOptions: { ...profile.providerOptions } }),
+        ...(profile.requiredCapabilities === undefined
+            ? {}
+            : {
+                requiredCapabilities: profile.requiredCapabilities.map((requirement) => ({
+                    name: requirement.name,
+                    ...(requirement.acceptedModes === undefined
+                        ? {}
+                        : { acceptedModes: [...requirement.acceptedModes] }),
+                })),
+            }),
+        ...(profile.metadata === undefined
+            ? {}
+            : { metadata: { ...profile.metadata } }),
+    };
+}
+function cloneConnection(connection) {
+    switch (connection.kind) {
+        case 'sdk':
+            return { ...connection };
+        case 'process':
+            return {
+                ...connection,
+                ...(connection.args === undefined
+                    ? {}
+                    : { args: [...connection.args] }),
+                ...(connection.envRefs === undefined
+                    ? {}
+                    : {
+                        envRefs: Object.fromEntries(Object.entries(connection.envRefs).map(([name, ref]) => [
+                            name,
+                            { ...ref },
+                        ])),
+                    }),
+            };
+        case 'endpoint':
+        case 'local_socket':
+            return {
+                ...connection,
+                ...(connection.authRef === undefined
+                    ? {}
+                    : { authRef: { ...connection.authRef } }),
+            };
+    }
+}
+function cloneDescriptor(descriptor) {
+    return {
+        ...descriptor,
+        connectionKinds: [...descriptor.connectionKinds],
+    };
+}
+function validateDescriptor(descriptor) {
+    if (descriptor.providerId.length === 0 ||
+        descriptor.displayName.trim().length === 0 ||
+        descriptor.connectionKinds.length === 0) {
+        throw new HarnessError('invalid_request', 'Provider descriptor is incomplete.', { retryable: false, providerId: descriptor.providerId });
+    }
+}
+function validateProfile(profile) {
+    if (profile.profileId.length === 0 ||
+        profile.providerId.length === 0 ||
+        profile.displayName.trim().length === 0) {
+        throw new HarnessError('profile_invalid', 'Profile is incomplete.', {
+            retryable: false,
+            providerId: profile.providerId,
+            profileId: profile.profileId,
+        });
+    }
+}
+function findUnmetCapability(manifest, profile) {
+    for (const requirement of profile.requiredCapabilities ?? []) {
+        const acceptedModes = requirement.acceptedModes ?? ['native'];
+        const observed = manifest.capabilities[requirement.name];
+        if (!isRecord(observed) ||
+            typeof observed.mode !== 'string' ||
+            !acceptedModes.includes(observed.mode)) {
+            return requirement.name;
+        }
+    }
+    return undefined;
+}
+function isCapabilityManifest(value) {
+    return (isRecord(value) &&
+        typeof value['providerId'] === 'string' &&
+        typeof value['profileId'] === 'string' &&
+        isRecord(value['capabilities']) &&
+        typeof value['observedAt'] === 'string');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+async function probeConnectedClient(client, profile, stage, probe) {
+    try {
+        return await probe();
+    }
+    catch (error) {
+        return rejectConnectedClient(client, isHarnessError(error)
+            ? error
+            : new HarnessError('provider_api_incompatible', `Connected Client ${stage} probe failed.`, {
+                retryable: false,
+                providerId: profile.providerId,
+                profileId: profile.profileId,
+                details: { stage },
+            }));
+    }
+}
+async function rejectConnectedClient(client, validationError) {
+    try {
+        await client.close();
+    }
+    catch {
+        throw new HarnessError('connection_failed', 'Connected Client failed validation and did not close cleanly.', {
+            retryable: false,
+            ...(validationError.providerId === undefined
+                ? {}
+                : { providerId: validationError.providerId }),
+            ...(validationError.profileId === undefined
+                ? {}
+                : { profileId: validationError.profileId }),
+            details: { validationCode: validationError.code },
+        });
+    }
+    throw validationError;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@harapter/core",
+  "version": "0.1.1",
+  "description": "Provider-agnostic portable contracts and registry for Harapter.",
+  "keywords": [
+    "agent",
+    "harness",
+    "ai",
+    "typescript"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yunfeizhu/harapter.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/yunfeizhu/harapter/issues"
+  },
+  "homepage": "https://github.com/yunfeizhu/harapter#readme",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/",
+    "tag": "next"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json"
+  }
+}