@inhuman.tools/harness-provider-sdk 0.0.0-stage → 0.1.0

package/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright 2026 Merkle Bonsai
+
+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/dist/auth.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Auth interaction shapes. OAuth/OIDC/PKCE live in provider-auth; adopt
+ * helpers stay with the connection registry (D3).
+ */
+import { AUTH_INTERACTION_KINDS } from "./schemas/provider.js";
+export type AuthInteractionKind = (typeof AUTH_INTERACTION_KINDS)[number];
+export type AuthInteraction = {
+    readonly kind: AuthInteractionKind;
+    readonly connectionId: string;
+};
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC"}

package/dist/auth.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":""}

package/dist/blobs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Read seam for stored blobs. The kernel's blob bucket belongs to the daemon;
+ * code that needs a blob's bytes (a provider projecting a wire, a recall tool)
+ * reads them through here and never imports the store. Keys are content hashes,
+ * so there is no session or id to pass: a hash a document names is the whole address.
+ */
+/** Bytes of one stored blob, or null when the hash is unknown or unreadable. */
+export type BlobReader = (sha256: string) => Uint8Array | null;
+/** The host that owns the bucket binds it once at boot. `null` unbinds. */
+export declare function bindBlobReader(read: BlobReader | null): void;
+/** Null while nothing is bound, so a caller falls back to the head the document kept. */
+export declare function readBlob(sha256: string): Uint8Array | null;
+//# sourceMappingURL=blobs.d.ts.map

package/dist/blobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobs.d.ts","sourceRoot":"","sources":["../src/blobs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAAC;AAI/D,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAE5D;AAED,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAE1D"}

package/dist/blobs.js

@@ -0,0 +1,16 @@
+/**
+ * Read seam for stored blobs. The kernel's blob bucket belongs to the daemon;
+ * code that needs a blob's bytes (a provider projecting a wire, a recall tool)
+ * reads them through here and never imports the store. Keys are content hashes,
+ * so there is no session or id to pass: a hash a document names is the whole address.
+ */
+let reader = null;
+/** The host that owns the bucket binds it once at boot. `null` unbinds. */
+export function bindBlobReader(read) {
+    reader = read;
+}
+/** Null while nothing is bound, so a caller falls back to the head the document kept. */
+export function readBlob(sha256) {
+    return reader === null ? null : reader(sha256);
+}
+//# sourceMappingURL=blobs.js.map

package/dist/blobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobs.js","sourceRoot":"","sources":["../src/blobs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,IAAI,MAAM,GAAsB,IAAI,CAAC;AAErC,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,IAAuB;IACpD,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/capabilities.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Known capability kinds and request/result envelopes.
+ *
+ * `can` on a driver is these short names (product law). PEW/model kinds stay
+ * the existing Expectation classes — v1 does not invent third-party wire kinds.
+ */
+import type { CompletionExpectation, CompletionMessage, CompletionResult, McpToolResult, WebExtractResult, WebSearchResult } from "@inhuman.tools/harness-model";
+import { CAPABILITY_KINDS } from "./schemas/provider.js";
+export type CapabilityKind = (typeof CAPABILITY_KINDS)[number];
+/** Sync tags of the harness-model PEW kinds each `can` token claims. */
+export declare const CAPABILITY_EXPECTATION: {
+    readonly completion: "harness:expectation:completion";
+    readonly mcp: "harness:expectation:mcp-tool";
+    readonly "web-search": "harness:expectation:web-search";
+    readonly "web-extract": "harness:expectation:web-extract";
+};
+export declare const CAPABILITY_METHOD: {
+    readonly completion: "complete";
+    readonly mcp: "callTool";
+    readonly "web-search": "webSearch";
+    readonly "web-extract": "webExtract";
+};
+export declare function isCapabilityKind(value: unknown): value is CapabilityKind;
+export declare function parseCapabilityKind(value: unknown): CapabilityKind;
+export declare function admitCapability(can: readonly string[], kind: CapabilityKind): boolean;
+export type CompleteFields = {
+    readonly model: string;
+    readonly promptText?: string;
+    readonly messages?: CompletionMessage[];
+    readonly responseSchemaJson?: string;
+    readonly systemNote?: string;
+    readonly signal?: AbortSignal;
+    /** Required. Homed on a session plexus. Mutated in place. */
+    readonly round: CompletionExpectation;
+};
+export type CompleteRequest = CompleteFields & {
+    readonly connectionId: string;
+};
+export type ConnectionCompleteRequest = CompleteFields;
+export type CompleteResult = CompletionResult;
+export type McpCallRequest = {
+    readonly connectionId: string;
+    readonly serverToolName: string;
+    readonly args: Record<string, unknown>;
+    readonly signal?: AbortSignal;
+    readonly onDispatch?: () => void;
+};
+export type ConnectionMcpCallRequest = Omit<McpCallRequest, "connectionId">;
+export type McpCallResult = McpToolResult;
+export type WebSearchRequest = {
+    readonly connectionId: string;
+    readonly query: string;
+    readonly limit?: number;
+    readonly signal?: AbortSignal;
+};
+export type ConnectionWebSearchRequest = Omit<WebSearchRequest, "connectionId">;
+export type WebSearchCapabilityResult = WebSearchResult;
+export type WebExtractRequest = {
+    readonly connectionId: string;
+    readonly url: string;
+    readonly charLimit?: number;
+    readonly signal?: AbortSignal;
+};
+export type ConnectionWebExtractRequest = Omit<WebExtractRequest, "connectionId">;
+export type WebExtractCapabilityResult = WebExtractResult;
+export type CapabilityRequest = {
+    readonly kind: "completion";
+    readonly request: CompleteRequest;
+} | {
+    readonly kind: "mcp";
+    readonly request: McpCallRequest;
+} | {
+    readonly kind: "web-search";
+    readonly request: WebSearchRequest;
+} | {
+    readonly kind: "web-extract";
+    readonly request: WebExtractRequest;
+};
+export type CapabilityResult = {
+    readonly kind: "completion";
+    readonly result: CompleteResult;
+} | {
+    readonly kind: "mcp";
+    readonly result: McpCallResult;
+} | {
+    readonly kind: "web-search";
+    readonly result: WebSearchCapabilityResult;
+} | {
+    readonly kind: "web-extract";
+    readonly result: WebExtractCapabilityResult;
+};
+/**
+ * Duck-typed interned connection face. Generic admission uses this, not a
+ * vendor `instanceof`.
+ */
+export type CapabilityConnection = {
+    readonly connectionId: string;
+    complete?(req: ConnectionCompleteRequest): Promise<CompleteResult>;
+    callTool?(req: ConnectionMcpCallRequest): Promise<McpCallResult>;
+    webSearch?(req: ConnectionWebSearchRequest): Promise<WebSearchCapabilityResult>;
+    webExtract?(req: ConnectionWebExtractRequest): Promise<WebExtractCapabilityResult>;
+};
+export declare function parseCapabilityRequest(value: unknown): CapabilityRequest;
+export declare function connectionSupports(connection: CapabilityConnection, kind: CapabilityKind): boolean;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

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

package/dist/capabilities.js

@@ -0,0 +1,32 @@
+import { parseWith } from "./parse.js";
+import { capabilityKindSchema, capabilityRequestSchema } from "./schemas/provider.js";
+/** Sync tags of the harness-model PEW kinds each `can` token claims. */
+export const CAPABILITY_EXPECTATION = {
+    completion: "harness:expectation:completion",
+    mcp: "harness:expectation:mcp-tool",
+    "web-search": "harness:expectation:web-search",
+    "web-extract": "harness:expectation:web-extract",
+};
+export const CAPABILITY_METHOD = {
+    completion: "complete",
+    mcp: "callTool",
+    "web-search": "webSearch",
+    "web-extract": "webExtract",
+};
+export function isCapabilityKind(value) {
+    return capabilityKindSchema.safeParse(value).success;
+}
+export function parseCapabilityKind(value) {
+    return parseWith(capabilityKindSchema, value);
+}
+export function admitCapability(can, kind) {
+    return can.includes(kind);
+}
+export function parseCapabilityRequest(value) {
+    return parseWith(capabilityRequestSchema, value);
+}
+export function connectionSupports(connection, kind) {
+    const method = CAPABILITY_METHOD[kind];
+    return typeof connection[method] === "function";
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAoB,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAIxG,wEAAwE;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,UAAU,EAAE,gCAAgC;IAC5C,GAAG,EAAE,8BAA8B;IACnC,YAAY,EAAE,gCAAgC;IAC9C,aAAa,EAAE,iCAAiC;CACC,CAAC;AAEpD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,UAAU,EAAE,UAAU;IACtB,GAAG,EAAE,UAAU;IACf,YAAY,EAAE,WAAW;IACzB,aAAa,EAAE,YAAY;CACsB,CAAC;AAEpD,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,oBAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,SAAS,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAsB,EAAE,IAAoB;IAC1E,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AA0ED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,SAAS,CAAC,uBAAuB,EAAE,KAAK,CAAsB,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAgC,EAAE,IAAoB;IACvF,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,OAAO,UAAU,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC;AAClD,CAAC"}

package/dist/descriptor.d.ts

@@ -0,0 +1,20 @@
+import type { DriverMultiplicity } from "@inhuman.tools/plexus-expectations";
+import type { CapabilityKind } from "./capabilities.js";
+import { type ProviderSdkContract } from "./identity.js";
+export type DriverDefinition = {
+    readonly name: string;
+    readonly description: string;
+    readonly abilityClaim: readonly CapabilityKind[];
+    readonly multiplicity: DriverMultiplicity;
+    readonly importPath: string;
+};
+export type ProviderDescriptor = {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly contract: ProviderSdkContract;
+    readonly drivers: readonly DriverDefinition[];
+};
+export declare function parseProviderDescriptor(value: unknown): ProviderDescriptor;
+export declare function isProviderDescriptor(value: unknown): value is ProviderDescriptor;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../src/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAKxE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACjD,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAE/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC/C,CAAC;AA0BF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAW1E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAMhF"}

package/dist/descriptor.js

@@ -0,0 +1,39 @@
+import { providerBrand } from "./identity.js";
+import { parseWith } from "./parse.js";
+import { PROVIDER_SDK_CONTRACT } from "./schemas/index.js";
+import { providerDescriptorSchema } from "./schemas/provider.js";
+function freezeDriver(row) {
+    return Object.freeze({
+        name: row.name,
+        description: row.description,
+        abilityClaim: Object.freeze([...row.abilityClaim]),
+        multiplicity: row.multiplicity,
+        importPath: row.importPath ?? row.name,
+    });
+}
+function rejectDuplicateDrivers(drivers, context) {
+    const seen = new Set();
+    for (const driver of drivers) {
+        if (seen.has(driver.name))
+            throw new Error(`${context}: driver "${driver.name}" collides`);
+        seen.add(driver.name);
+    }
+}
+export function parseProviderDescriptor(value) {
+    const parsed = parseWith(providerDescriptorSchema, value);
+    rejectDuplicateDrivers(parsed.drivers, "provider-sdk");
+    return Object.freeze({
+        [providerBrand.descriptor]: true,
+        id: parsed.id,
+        name: parsed.name,
+        description: parsed.description ?? "",
+        contract: PROVIDER_SDK_CONTRACT,
+        drivers: Object.freeze(parsed.drivers.map(freezeDriver)),
+    });
+}
+export function isProviderDescriptor(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[providerBrand.descriptor] === true);
+}
+//# sourceMappingURL=descriptor.js.map

package/dist/descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../src/descriptor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAA4B,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAmBjE,SAAS,YAAY,CAAC,GAMrB;IACC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;QAClD,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,IAAI;KACvC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAoC,EAAE,OAAe;IACnF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,aAAa,MAAM,CAAC,IAAI,YAAY,CAAC,CAAC;QAC3F,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,MAAM,GAAG,SAAS,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC1D,sBAAsB,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,IAAa;QACzC,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;QACrC,QAAQ,EAAE,qBAAqB;QAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;KACzD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAkC,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,IAAI,CACvE,CAAC;AACJ,CAAC"}

package/dist/driver.d.ts

@@ -0,0 +1,5 @@
+import { DriverSpec } from "@inhuman.tools/plexus-expectations";
+import type { DriverDefinition } from "./descriptor.js";
+/** Declarations fill DriverSpec inventory. Process facts stay untouched. */
+export declare function applyDriverDefinition(spec: DriverSpec, driver: DriverDefinition): void;
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAMtF"}

package/dist/driver.js

@@ -0,0 +1,9 @@
+/** Declarations fill DriverSpec inventory. Process facts stay untouched. */
+export function applyDriverDefinition(spec, driver) {
+    spec.name = driver.name;
+    spec.description = driver.description;
+    spec.importPath = driver.importPath;
+    spec.abilityClaim = [...driver.abilityClaim];
+    spec.multiplicity = driver.multiplicity;
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAIA,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CAAC,IAAgB,EAAE,MAAwB;IAC9E,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACxB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACtC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACpC,IAAI,CAAC,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7C,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;AAC1C,CAAC"}

package/dist/identity.d.ts

@@ -0,0 +1,10 @@
+import { PROVIDER_SDK_CONTRACT } from "./schemas/provider.js";
+/** Process-local brands. Not plugin-sdk InhumanPlugin and not a PEW kind. */
+export declare const providerBrand: {
+    readonly descriptor: symbol;
+    readonly registration: symbol;
+    readonly driver: symbol;
+};
+export type ProviderSdkContract = typeof PROVIDER_SDK_CONTRACT;
+export declare function isCompatibleContract(contract: unknown): contract is ProviderSdkContract;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,6EAA6E;AAC7E,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,OAAO,qBAAqB,CAAC;AAE/D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,mBAAmB,CAEvF"}

package/dist/identity.js

@@ -0,0 +1,11 @@
+import { PROVIDER_SDK_CONTRACT } from "./schemas/provider.js";
+/** Process-local brands. Not plugin-sdk InhumanPlugin and not a PEW kind. */
+export const providerBrand = {
+    descriptor: Symbol.for("@inhuman.tools/harness-provider-sdk:descriptor"),
+    registration: Symbol.for("@inhuman.tools/harness-provider-sdk:registration"),
+    driver: Symbol.for("@inhuman.tools/harness-provider-sdk:driver"),
+};
+export function isCompatibleContract(contract) {
+    return contract === PROVIDER_SDK_CONTRACT;
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,gDAAgD,CAAC;IACxE,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,kDAAkD,CAAC;IAC5E,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,4CAA4C,CAAC;CACxD,CAAC;AAIX,MAAM,UAAU,oBAAoB,CAAC,QAAiB;IACpD,OAAO,QAAQ,KAAK,qBAAqB,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @inhuman.tools/harness-provider-sdk — driver-provider descriptors,
+ * registration identity, and capability request/result contracts on PEW.
+ *
+ * Not a vendor completion class, not InhumanPlugin, not a plugin loader.
+ */
+export type * from "./auth.js";
+export { AUTH_INTERACTION_KINDS as AUTH_INTERACTION_KINDS } from "./schemas/index.js";
+export * from "./blobs.js";
+export * from "./capabilities.js";
+export { CAPABILITY_KINDS as CAPABILITY_KINDS } from "./schemas/index.js";
+export * from "./descriptor.js";
+export * from "./driver.js";
+export * from "./identity.js";
+export { PROVIDER_SDK_CONTRACT as PROVIDER_SDK_CONTRACT } from "./schemas/index.js";
+export * from "./registration.js";
+export * from "./visuals.js";
+export { authInteractionSchema as authInteractionSchema, capabilityKindSchema as capabilityKindSchema, capabilityRequestSchema as capabilityRequestSchema, completeRequestSchema as completeRequestSchema, driverConnectionClassSchema as driverConnectionClassSchema, driverDefinitionSchema as driverDefinitionSchema, mcpCallRequestSchema as mcpCallRequestSchema, multiplicitySchema as multiplicitySchema, providerDescriptorSchema as providerDescriptorSchema, providerRegistrationSchema as providerRegistrationSchema, registeredDriverInputSchema as registeredDriverInputSchema, webExtractRequestSchema as webExtractRequestSchema, webSearchRequestSchema as webSearchRequestSchema, } from "./schemas/index.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;;;;;GAKG;AAEH,mBAAmB,WAAW,CAAC;AAC/B,OAAO,EAAE,sBAAsB,IAAI,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACtF,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,gBAAgB,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,qBAAqB,IAAI,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACpF,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,qBAAqB,IAAI,qBAAqB,EAC9C,oBAAoB,IAAI,oBAAoB,EAC5C,uBAAuB,IAAI,uBAAuB,EAClD,qBAAqB,IAAI,qBAAqB,EAC9C,2BAA2B,IAAI,2BAA2B,EAC1D,sBAAsB,IAAI,sBAAsB,EAChD,oBAAoB,IAAI,oBAAoB,EAC5C,kBAAkB,IAAI,kBAAkB,EACxC,wBAAwB,IAAI,wBAAwB,EACpD,0BAA0B,IAAI,0BAA0B,EACxD,2BAA2B,IAAI,2BAA2B,EAC1D,uBAAuB,IAAI,uBAAuB,EAClD,sBAAsB,IAAI,sBAAsB,GACjD,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @inhuman.tools/harness-provider-sdk — driver-provider descriptors,
+ * registration identity, and capability request/result contracts on PEW.
+ *
+ * Not a vendor completion class, not InhumanPlugin, not a plugin loader.
+ */
+export { AUTH_INTERACTION_KINDS as AUTH_INTERACTION_KINDS } from "./schemas/index.js";
+export * from "./blobs.js";
+export * from "./capabilities.js";
+export { CAPABILITY_KINDS as CAPABILITY_KINDS } from "./schemas/index.js";
+export * from "./descriptor.js";
+export * from "./driver.js";
+export * from "./identity.js";
+export { PROVIDER_SDK_CONTRACT as PROVIDER_SDK_CONTRACT } from "./schemas/index.js";
+export * from "./registration.js";
+export * from "./visuals.js";
+export { authInteractionSchema as authInteractionSchema, capabilityKindSchema as capabilityKindSchema, capabilityRequestSchema as capabilityRequestSchema, completeRequestSchema as completeRequestSchema, driverConnectionClassSchema as driverConnectionClassSchema, driverDefinitionSchema as driverDefinitionSchema, mcpCallRequestSchema as mcpCallRequestSchema, multiplicitySchema as multiplicitySchema, providerDescriptorSchema as providerDescriptorSchema, providerRegistrationSchema as providerRegistrationSchema, registeredDriverInputSchema as registeredDriverInputSchema, webExtractRequestSchema as webExtractRequestSchema, webSearchRequestSchema as webSearchRequestSchema, } from "./schemas/index.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":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,sBAAsB,IAAI,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACtF,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,gBAAgB,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,qBAAqB,IAAI,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACpF,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,qBAAqB,IAAI,qBAAqB,EAC9C,oBAAoB,IAAI,oBAAoB,EAC5C,uBAAuB,IAAI,uBAAuB,EAClD,qBAAqB,IAAI,qBAAqB,EAC9C,2BAA2B,IAAI,2BAA2B,EAC1D,sBAAsB,IAAI,sBAAsB,EAChD,oBAAoB,IAAI,oBAAoB,EAC5C,kBAAkB,IAAI,kBAAkB,EACxC,wBAAwB,IAAI,wBAAwB,EACpD,0BAA0B,IAAI,0BAA0B,EACxD,2BAA2B,IAAI,2BAA2B,EAC1D,uBAAuB,IAAI,uBAAuB,EAClD,sBAAsB,IAAI,sBAAsB,GACjD,MAAM,oBAAoB,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,3 @@
+import { z } from "zod";
+export declare function parseWith<T>(schema: z.ZodType<T>, value: unknown, context?: string): T;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,SAAiB,GAAG,CAAC,CAM9F"}

package/dist/parse.js

@@ -0,0 +1,9 @@
+export function parseWith(schema, value, context = "provider-sdk") {
+    const result = schema.safeParse(value);
+    if (result.success)
+        return result.data;
+    const issue = result.error.issues[0];
+    const path = issue.path.length > 0 ? `${issue.path.join(".")}: ` : "";
+    throw new Error(`${context}: ${path}${issue.message}`);
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAI,MAAoB,EAAE,KAAc,EAAE,OAAO,GAAG,cAAc;IACzF,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,KAAK,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/registration.d.ts

@@ -0,0 +1,24 @@
+import type { DriverConnectionClass } from "@inhuman.tools/plexus-expectations/driver";
+import { type DriverDefinition } from "./descriptor.js";
+import { type ProviderSdkContract } from "./identity.js";
+export type RegisteredDriver = DriverDefinition & {
+    readonly providerId: string;
+    readonly connection: DriverConnectionClass;
+};
+export type RegisteredProvider = {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly contract: ProviderSdkContract;
+    readonly drivers: readonly RegisteredDriver[];
+};
+export declare function parseProviderRegistration(value: unknown): RegisteredProvider;
+/**
+ * Compose a roster. Duplicate provider ids or driver names fail before any
+ * connection is constructed — identity is catalog keys, not intern slots.
+ */
+export declare function registerProviders(inputs: readonly unknown[]): RegisteredProvider[];
+export declare function flattenDrivers(providers: readonly RegisteredProvider[]): readonly RegisteredDriver[];
+export declare function isRegisteredProvider(value: unknown): value is RegisteredProvider;
+export declare function isRegisteredDriver(value: unknown): value is RegisteredDriver;
+//# sourceMappingURL=registration.d.ts.map

package/dist/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../src/registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAGvF,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAKxE,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG;IAEhD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAE/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC/C,CAAC;AAiCF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAW5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAiBlF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,gBAAgB,EAAE,CAEpG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAMhF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAI5E"}

package/dist/registration.js

@@ -0,0 +1,70 @@
+import { providerBrand } from "./identity.js";
+import { parseWith } from "./parse.js";
+import { PROVIDER_SDK_CONTRACT } from "./schemas/index.js";
+import { providerRegistrationSchema } from "./schemas/provider.js";
+function freezeRegisteredDriver(providerId, row) {
+    return Object.freeze({
+        [providerBrand.driver]: true,
+        providerId,
+        name: row.name,
+        description: row.description,
+        abilityClaim: Object.freeze([...row.abilityClaim]),
+        multiplicity: row.multiplicity,
+        importPath: row.importPath ?? row.name,
+        connection: row.connection,
+    });
+}
+function rejectDuplicateDrivers(drivers, context) {
+    const seen = new Set();
+    for (const driver of drivers) {
+        if (seen.has(driver.name))
+            throw new Error(`${context}: driver "${driver.name}" collides`);
+        seen.add(driver.name);
+    }
+}
+export function parseProviderRegistration(value) {
+    const parsed = parseWith(providerRegistrationSchema, value);
+    rejectDuplicateDrivers(parsed.drivers, "provider-sdk");
+    return Object.freeze({
+        [providerBrand.registration]: true,
+        id: parsed.id,
+        name: parsed.name,
+        description: parsed.description ?? "",
+        contract: PROVIDER_SDK_CONTRACT,
+        drivers: Object.freeze(parsed.drivers.map((row) => freezeRegisteredDriver(parsed.id, row))),
+    });
+}
+/**
+ * Compose a roster. Duplicate provider ids or driver names fail before any
+ * connection is constructed — identity is catalog keys, not intern slots.
+ */
+export function registerProviders(inputs) {
+    const providers = inputs.map((input) => parseProviderRegistration(input));
+    const providerIds = new Set();
+    const driverNames = new Set();
+    for (const provider of providers) {
+        if (providerIds.has(provider.id)) {
+            throw new Error(`provider-sdk: provider "${provider.id}" collides`);
+        }
+        providerIds.add(provider.id);
+        for (const driver of provider.drivers) {
+            if (driverNames.has(driver.name)) {
+                throw new Error(`provider-sdk: driver "${driver.name}" collides`);
+            }
+            driverNames.add(driver.name);
+        }
+    }
+    return providers;
+}
+export function flattenDrivers(providers) {
+    return providers.flatMap((provider) => provider.drivers);
+}
+export function isRegisteredProvider(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[providerBrand.registration] === true);
+}
+export function isRegisteredDriver(value) {
+    return (typeof value === "object" && value !== null && value[providerBrand.driver] === true);
+}
+//# sourceMappingURL=registration.js.map

package/dist/registration.js.map

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

package/dist/schemas/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./provider.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/schemas/index.js

@@ -0,0 +1,2 @@
+export * from "./provider.js";
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

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