@relkit/langchain 0.0.0-stage → 0.7.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rel-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# @relkit/langchain
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Agents accept native LangChain models, tools, and middleware with finite execution limits. RelKit
+function-backed tools preserve validation, authorization, and policy while participating in the same native
+execution. Adding subagents, skills, memory files, or a backend selects DeepAgents behavior through the
+same declaration.
+
+```ts
+import { defineAgent } from "@relkit/langchain";
+import { z } from "@relkit/app/schema";
+import { FakeToolCallingModel, todoListMiddleware } from "langchain";
+import lookupOrder from "./lookup-order.tool.js";
+
+export default defineAgent({
+  id: "orders.support-agent",
+  input: z.object({ question: z.string().min(1) }),
+  output: z.object({ answer: z.string() }),
+  model: new FakeToolCallingModel(),
+  instructions: "Answer order questions with the read-only lookup tool.",
+  tools: [lookupOrder],
+  middleware: [todoListMiddleware()],
+  limits: { maxSteps: 4, maxToolCalls: 4, timeoutMs: 10_000 },
+  stateProfile: "default",
+  client: { public: true, state: ["todos"] },
+});
+```
+
+Production applications install their LangChain model package and provide a compatible instance or lazy
+factory from server code. Credentials and native provider instances never enter generated browser
+contracts. Tests can use native fake models without network access or paid services.
+
+Client-exposed agents require an agent-state profile. Every run, observation, control, and continuation
+also requires an application-owned thread ID; RelKit never derives or invents that business identity.
+
+Only allowlisted tools execute, and RELKIT approval remains authoritative. Runtime hooks expose safe
+agent, model, and tool span metadata; prompts, results, secrets, and full tool content remain omitted
+unless bounded development-redacted capture is selected.
+
+Generic declarations remain available from `@relkit/app/agents`. Install this integration and its selected SDK peers for native execution; DeepAgents is required only for subagents, skills, memory files, a native backend or interrupt controls.
+
+| API                                                                   | Import                      |
+| --------------------------------------------------------------------- | --------------------------- |
+| Generic `defineAgent`, RELKIT refs, public events and state contracts | `@relkit/app/agents`        |
+| Native `defineAgent`, model/tool/middleware types                     | `@relkit/langchain`         |
+| `defineGraph`, graph nodes/edges, native persistence resources        | `@relkit/langchain`         |
+| Explicit execution, dependency check and persistence release          | `@relkit/langchain/runtime` |
+| Scripted native `createTestAgent` / `createTestModel`                 | `@relkit/langchain/testing` |
+
+The compiler derives execution selection from descriptors. There is no additional application engine registration flag. Native middleware state inference and graph state inference retain their native SDK types.

package/dist/client-contract-metadata.d.ts

@@ -0,0 +1,31 @@
+/** Projects native agent and graph schemas into serializable client metadata; SDK-specific inspection remains inside this integration before the generic contract is published. */
+import { Effect } from "effect";
+import type { AgentClientContractMetadata, AgentClientMetadataOptions, GraphClientMetadataOptions } from "./client-contract-metadata.types.js";
+export type * from "./client-contract-metadata.types.js";
+/** Builds client contract metadata for a native agent.
+ * @param options - Agent tools, middleware, public policy, and nested agents.
+ * @returns An Effect with metadata or AgentDefinitionFailure.
+ * @example Effect.runSync(agentClientContractMetadataEffect(options));
+ */
+export declare const agentClientContractMetadataEffect: (options: AgentClientMetadataOptions) => Effect.Effect<AgentClientContractMetadata, import("@relkit/agents/internal/define-agent-error").AgentDefinitionFailure, never>;
+/** Builds native agent metadata for existing synchronous callers.
+ * @param options - Agent tools, middleware, public policy, and nested agents.
+ * @returns Frozen client contract metadata.
+ * @throws The original invalid metadata error.
+ * @example agentClientContractMetadata(options);
+ */
+export declare function agentClientContractMetadata(options: AgentClientMetadataOptions): AgentClientContractMetadata;
+/** Builds client contract metadata for a native graph.
+ * @param options - Graph state, workflow, and public policy.
+ * @returns An Effect with metadata or GraphDefinitionFailure.
+ * @example Effect.runSync(graphClientContractMetadataEffect(options));
+ */
+export declare const graphClientContractMetadataEffect: (options: GraphClientMetadataOptions) => Effect.Effect<AgentClientContractMetadata, import("./define-graph-error.js").GraphDefinitionFailure, never>;
+/** Builds graph metadata for existing synchronous callers.
+ * @param options - Graph state, workflow, and public policy.
+ * @returns Frozen client contract metadata.
+ * @throws The original invalid graph metadata error.
+ * @example graphClientContractMetadata(options);
+ */
+export declare function graphClientContractMetadata(options: GraphClientMetadataOptions): AgentClientContractMetadata;
+//# sourceMappingURL=client-contract-metadata.d.ts.map

package/dist/client-contract-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-contract-metadata.d.ts","sourceRoot":"","sources":["../src/client-contract-metadata.ts"],"names":[],"mappings":"AAAA,mLAAmL;AAGnL,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAahC,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAK1B,0BAA0B,EAE3B,MAAM,qCAAqC,CAAC;AAE7C,mBAAmB,qCAAqC,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,yKAO7C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,0BAA0B,GAClC,2BAA2B,CAM7B;AAyBD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,sJAO7C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,0BAA0B,GAClC,2BAA2B,CAM7B"}

package/dist/client-contract-metadata.js

@@ -0,0 +1,129 @@
+/** Projects native agent and graph schemas into serializable client metadata; SDK-specific inspection remains inside this integration before the generic contract is published. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { clientSchemaMetadata, dynamicClientSchema, mergeClientSchemas, selectedClientFields, } from "./client-contract-schema.js";
+import { agentDefinitionFailure } from "@relkit/agents/internal/define-agent-error";
+import { graphDefinitionFailure } from "./define-graph-error.js";
+/** Builds client contract metadata for a native agent.
+ * @param options - Agent tools, middleware, public policy, and nested agents.
+ * @returns An Effect with metadata or AgentDefinitionFailure.
+ * @example Effect.runSync(agentClientContractMetadataEffect(options));
+ */
+export const agentClientContractMetadataEffect = Effect.fn("Agents.client.agentMetadata")((options) => Effect.try({
+    try: () => agentClientContractMetadataCore(options),
+    catch: agentDefinitionFailure,
+}), (effect) => observeAgent("client.agent-metadata", effect));
+/** Builds native agent metadata for existing synchronous callers.
+ * @param options - Agent tools, middleware, public policy, and nested agents.
+ * @returns Frozen client contract metadata.
+ * @throws The original invalid metadata error.
+ * @example agentClientContractMetadata(options);
+ */
+export function agentClientContractMetadata(options) {
+    return Effect.runSync(agentClientContractMetadataEffect(options).pipe(Effect.catchTag("AgentDefinitionFailure", (failure) => Effect.fail(failure.cause))));
+}
+function agentClientContractMetadataCore(options) {
+    const stateSchema = mergeClientSchemas(options.middleware.map((item) => item.stateSchema));
+    const scopes = [{ kind: "agent", id: options.id }];
+    collectSubagents(options.subagents, scopes);
+    scopes.push({ kind: "dynamic" });
+    return Object.freeze({
+        tools: toolMetadata([
+            ...options.tools,
+            ...options.middleware.flatMap((item) => ("tools" in item ? item.tools : undefined)),
+        ]),
+        state: selectedClientFields(stateSchema, options.client?.state),
+        events: eventFields(options.client),
+        scopes: Object.freeze(scopes),
+        waiting: (options.interruptOn === undefined
+            ? Object.freeze([])
+            : Object.freeze([
+                { scope: { kind: "dynamic" }, response: dynamicClientSchema },
+            ])),
+    });
+}
+/** Builds client contract metadata for a native graph.
+ * @param options - Graph state, workflow, and public policy.
+ * @returns An Effect with metadata or GraphDefinitionFailure.
+ * @example Effect.runSync(graphClientContractMetadataEffect(options));
+ */
+export const graphClientContractMetadataEffect = Effect.fn("Agents.client.graphMetadata")((options) => Effect.try({
+    try: () => graphClientContractMetadataCore(options),
+    catch: graphDefinitionFailure,
+}), (effect) => observeAgent("client.graph-metadata", effect));
+/** Builds graph metadata for existing synchronous callers.
+ * @param options - Graph state, workflow, and public policy.
+ * @returns Frozen client contract metadata.
+ * @throws The original invalid graph metadata error.
+ * @example graphClientContractMetadata(options);
+ */
+export function graphClientContractMetadata(options) {
+    return Effect.runSync(graphClientContractMetadataEffect(options).pipe(Effect.catchTag("GraphDefinitionFailure", (failure) => Effect.fail(failure.cause))));
+}
+function graphClientContractMetadataCore(options) {
+    const scopes = [{ kind: "agent", id: options.id }];
+    const waiting = [];
+    collectWorkflow(options.workflow, scopes, waiting);
+    return Object.freeze({
+        tools: Object.freeze([]),
+        state: selectedClientFields(clientSchemaMetadata(options.state.getJsonSchema()), options.client?.state),
+        events: eventFields(options.client),
+        scopes: Object.freeze(scopes),
+        waiting: Object.freeze(waiting),
+    });
+}
+function collectSubagents(subagents, scopes) {
+    for (const subagent of subagents ?? []) {
+        scopes.push({ kind: "subagent", id: subagent.id });
+        collectSubagents(subagent.subagents, scopes);
+    }
+}
+function collectWorkflow(workflow, scopes, waiting) {
+    for (const node of workflow.nodes) {
+        const scope = { kind: "node", id: node.id };
+        scopes.push(scope);
+        if (node.resume !== undefined)
+            waiting.push({ scope, response: node.resume });
+        if (node.workflow !== undefined)
+            collectWorkflow(node.workflow, scopes, waiting);
+    }
+}
+function eventFields(client) {
+    return Object.freeze(Object.entries(client?.events ?? {}).map(([name, value]) => ({
+        name,
+        schema: clientSchemaMetadata(value),
+    })));
+}
+function toolMetadata(values) {
+    const tools = new Map();
+    let hasDynamic = false;
+    for (const value of values) {
+        if (!isRecord(value)) {
+            hasDynamic = true;
+            continue;
+        }
+        const ref = isRecord(value.ref) && value.ref.kind === "tool" ? value.ref : undefined;
+        const id = typeof ref?.id === "string"
+            ? ref.id
+            : typeof value.name === "string"
+                ? value.name
+                : undefined;
+        if (id === undefined) {
+            hasDynamic = true;
+            continue;
+        }
+        if (tools.has(id))
+            continue;
+        const target = isRecord(value.target) ? value.target : undefined;
+        tools.set(id, {
+            id,
+            input: clientSchemaMetadata(target?.input ?? value.schema),
+            output: clientSchemaMetadata(target?.output ?? value.outputSchema),
+        });
+    }
+    return Object.freeze([...tools.values(), ...(hasDynamic ? [dynamicClientSchema] : [])]);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=client-contract-metadata.js.map

package/dist/client-contract-metadata.js.map

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

package/dist/client-contract-metadata.types.d.ts

@@ -0,0 +1,59 @@
+/** Projects native agent and graph schemas into serializable client metadata; SDK-specific inspection remains inside this integration before the generic contract is published. This companion preserves the native input and output types without starting runtime work. */
+import type { AgentClientPolicy } from "@relkit/agents/internal/agent-client";
+import type { ClientSchemaMetadata, ClientTypeField } from "./client-contract-schema.js";
+import type { AgentMiddleware, AgentTool } from "./define-agent-native.js";
+import type { GraphWorkflow } from "./graph-workflow.js";
+/** Client visible event schema or dynamic event marker. */
+export type ClientEventMetadata = ClientTypeField | {
+    readonly kind: "dynamic";
+};
+/** Client visible tool schema or dynamic tool marker. */
+export type ClientToolMetadata = {
+    readonly id: string;
+    readonly input: ClientSchemaMetadata;
+    readonly output: ClientSchemaMetadata;
+} | {
+    readonly kind: "dynamic";
+};
+/** Client visible agent, subagent, or graph node scope. */
+export interface ClientScopeMetadata {
+    readonly kind: "agent" | "subagent" | "node" | "dynamic";
+    readonly id?: string;
+}
+/** Client visible continuation response schema. */
+export interface ClientWaitingMetadata {
+    readonly scope: ClientScopeMetadata;
+    readonly response: ClientSchemaMetadata;
+}
+/** Complete metadata needed to generate an agent client contract. */
+export interface AgentClientContractMetadata {
+    readonly tools: readonly ClientToolMetadata[];
+    readonly state: readonly ClientTypeField[];
+    readonly events: readonly ClientEventMetadata[];
+    readonly scopes: readonly ClientScopeMetadata[];
+    readonly waiting: readonly ClientWaitingMetadata[];
+}
+/** Source of nested subagent scope identities. */
+export interface SubagentMetadataSource {
+    readonly id: string;
+    readonly subagents?: readonly SubagentMetadataSource[];
+}
+/** Inputs for native agent client metadata. */
+export interface AgentClientMetadataOptions {
+    readonly id: string;
+    readonly tools: readonly AgentTool[];
+    readonly middleware: readonly AgentMiddleware[];
+    readonly client?: AgentClientPolicy;
+    readonly subagents?: readonly SubagentMetadataSource[];
+    readonly interruptOn?: Readonly<Record<string, unknown>>;
+}
+/** Inputs for graph client metadata. */
+export interface GraphClientMetadataOptions {
+    readonly id: string;
+    readonly state: {
+        readonly getJsonSchema: () => unknown;
+    };
+    readonly client?: AgentClientPolicy;
+    readonly workflow: GraphWorkflow;
+}
+//# sourceMappingURL=client-contract-metadata.types.d.ts.map

package/dist/client-contract-metadata.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-contract-metadata.types.d.ts","sourceRoot":"","sources":["../src/client-contract-metadata.types.ts"],"names":[],"mappings":"AAAA,6QAA6Q;AAE7Q,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,2DAA2D;AAC3D,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEjF,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEjC,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;CACzC;AAED,qEAAqE;AACrE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACpD;AAED,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACxD;AAED,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1D;AAED,wCAAwC;AACxC,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAA;KAAE,CAAC;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC"}

package/dist/client-contract-metadata.types.js

@@ -0,0 +1,3 @@
+/** Projects native agent and graph schemas into serializable client metadata; SDK-specific inspection remains inside this integration before the generic contract is published. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=client-contract-metadata.types.js.map

package/dist/client-contract-metadata.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-contract-metadata.types.js","sourceRoot":"","sources":["../src/client-contract-metadata.types.ts"],"names":[],"mappings":"AAAA,6QAA6Q"}

package/dist/client-contract-schema.d.ts

@@ -0,0 +1,66 @@
+/** Inspects native schema adapters to describe client-visible inputs and outputs; unsupported shapes produce the existing contract errors before execution. */
+import type { JsonValue } from "@relkit/contracts";
+import { Effect } from "effect";
+import type { ClientSchemaMetadata, ClientTypeField } from "@relkit/agents/internal/client-contract-schema.types";
+export type { ClientSchemaMetadata, ClientTypeField, } from "@relkit/agents/internal/client-contract-schema.types";
+/** Marker for a schema that cannot be represented in the client contract. */
+export declare const dynamicClientSchema: Readonly<{
+    kind: "dynamic";
+}>;
+/**
+ * Merges projected object schemas while preserving input order.
+ *
+ * @param values - Source schemas and schema-like values.
+ * @returns An Effect with the merged JSON schema; it has no typed failure.
+ * @example
+ * const schema = Effect.runSync(mergeClientSchemasEffect([{ type: "object" }]));
+ */
+export declare const mergeClientSchemasEffect: (values: readonly unknown[]) => Effect.Effect<JsonValue, never, never>;
+/**
+ * Synchronously merges client schemas for existing descriptor callers.
+ *
+ * @param values - Source schemas and schema-like values.
+ * @returns The merged JSON schema.
+ * @example
+ * const schema = mergeClientSchemas([{ type: "object" }]);
+ */
+export declare function mergeClientSchemas(values: readonly unknown[]): ClientSchemaMetadata;
+/**
+ * Selects named client state fields from a projected object schema.
+ *
+ * @param schema - Projected client schema.
+ * @param keys - Field names to expose, in the desired order.
+ * @returns An Effect with immutable field metadata; it has no typed failure.
+ * @example
+ * const fields = Effect.runSync(selectedClientFieldsEffect({ type: "object" }, ["name"]));
+ */
+export declare const selectedClientFieldsEffect: (schema: ClientSchemaMetadata, keys?: readonly string[] | undefined) => Effect.Effect<readonly ClientTypeField[], never, never>;
+/**
+ * Synchronously selects client fields for existing descriptor callers.
+ *
+ * @param schema - Projected client schema.
+ * @param keys - Field names to expose.
+ * @returns Immutable field metadata.
+ * @example
+ * const fields = selectedClientFields({ type: "object" }, ["name"]);
+ */
+export declare function selectedClientFields(schema: ClientSchemaMetadata, keys?: readonly string[]): readonly ClientTypeField[];
+/**
+ * Projects a schema-like value to safe client metadata.
+ *
+ * @param value - A JSON Schema document or a LangChain-compatible schema.
+ * @returns An Effect with projected metadata or the dynamic marker; it has no typed failure.
+ * @example
+ * const metadata = Effect.runSync(clientSchemaMetadataEffect({ type: "string" }));
+ */
+export declare const clientSchemaMetadataEffect: (value: unknown) => Effect.Effect<ClientSchemaMetadata, never, never>;
+/**
+ * Synchronously projects schema metadata for existing descriptor callers.
+ *
+ * @param value - A JSON Schema document or a LangChain-compatible schema.
+ * @returns Projected metadata or the dynamic marker.
+ * @example
+ * const metadata = clientSchemaMetadata({ type: "string" });
+ */
+export declare function clientSchemaMetadata(value: unknown): ClientSchemaMetadata;
+//# sourceMappingURL=client-contract-schema.d.ts.map

package/dist/client-contract-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-contract-schema.d.ts","sourceRoot":"","sources":["../src/client-contract-schema.ts"],"names":[],"mappings":"AAAA,+JAA+J;AAG/J,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAExC,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAChB,MAAM,sDAAsD,CAAC;AAE9D,YAAY,EACV,oBAAoB,EACpB,eAAe,GAChB,MAAM,sDAAsD,CAAC;AAE9D,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB;;EAA8C,CAAC;AAM/E;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,wEAgBpC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,oBAAoB,CAEnF;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,iIAuBtC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GACvB,SAAS,eAAe,EAAE,CAE5B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,uEActC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAEzE"}

package/dist/client-contract-schema.js

@@ -0,0 +1,153 @@
+/** Inspects native schema adapters to describe client-visible inputs and outputs; unsupported shapes produce the existing contract errors before execution. */
+import { toJsonSchema } from "@langchain/core/utils/json_schema";
+import { Effect, Metric } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+/** Marker for a schema that cannot be represented in the client contract. */
+export const dynamicClientSchema = Object.freeze({ kind: "dynamic" });
+const mergeCount = Metric.counter("relkit.agents.client_schema.merge.total");
+const selectCount = Metric.counter("relkit.agents.client_schema.select.total");
+const projectCount = Metric.counter("relkit.agents.client_schema.project.total");
+/**
+ * Merges projected object schemas while preserving input order.
+ *
+ * @param values - Source schemas and schema-like values.
+ * @returns An Effect with the merged JSON schema; it has no typed failure.
+ * @example
+ * const schema = Effect.runSync(mergeClientSchemasEffect([{ type: "object" }]));
+ */
+export const mergeClientSchemasEffect = Effect.fn("Agents.clientSchema.merge")(function* (values) {
+    const documents = [];
+    for (const value of values) {
+        const document = yield* clientSchemaMetadataEffect(value);
+        if (isJsonSchemaObject(document))
+            documents.push(document);
+    }
+    const merged = {
+        type: "object",
+        properties: Object.assign({}, ...documents.map(schemaProperties)),
+        required: [...new Set(documents.flatMap(schemaRequired))],
+    };
+    yield* Metric.update(mergeCount, 1);
+    return merged;
+}, (effect) => observeAgent("client-schema.merge", effect));
+/**
+ * Synchronously merges client schemas for existing descriptor callers.
+ *
+ * @param values - Source schemas and schema-like values.
+ * @returns The merged JSON schema.
+ * @example
+ * const schema = mergeClientSchemas([{ type: "object" }]);
+ */
+export function mergeClientSchemas(values) {
+    return Effect.runSync(mergeClientSchemasEffect(values));
+}
+/**
+ * Selects named client state fields from a projected object schema.
+ *
+ * @param schema - Projected client schema.
+ * @param keys - Field names to expose, in the desired order.
+ * @returns An Effect with immutable field metadata; it has no typed failure.
+ * @example
+ * const fields = Effect.runSync(selectedClientFieldsEffect({ type: "object" }, ["name"]));
+ */
+export const selectedClientFieldsEffect = Effect.fn("Agents.clientSchema.select")(function* (schema, keys) {
+    const fields = yield* Effect.sync(() => {
+        if (keys === undefined || !isJsonSchemaObject(schema))
+            return Object.freeze([]);
+        const required = new Set(schemaRequired(schema));
+        const properties = schemaProperties(schema);
+        return Object.freeze(keys.map((name) => {
+            const value = properties[name];
+            const field = value === undefined ? dynamicClientSchema : value;
+            const defaulted = isRecord(field) && Object.hasOwn(field, "default");
+            return {
+                name,
+                schema: field,
+                ...(!required.has(name) && !defaulted ? { optional: true } : {}),
+            };
+        }));
+    });
+    yield* Metric.update(selectCount, 1);
+    return fields;
+}, (effect) => observeAgent("client-schema.select", effect));
+/**
+ * Synchronously selects client fields for existing descriptor callers.
+ *
+ * @param schema - Projected client schema.
+ * @param keys - Field names to expose.
+ * @returns Immutable field metadata.
+ * @example
+ * const fields = selectedClientFields({ type: "object" }, ["name"]);
+ */
+export function selectedClientFields(schema, keys) {
+    return Effect.runSync(selectedClientFieldsEffect(schema, keys));
+}
+/**
+ * Projects a schema-like value to safe client metadata.
+ *
+ * @param value - A JSON Schema document or a LangChain-compatible schema.
+ * @returns An Effect with projected metadata or the dynamic marker; it has no typed failure.
+ * @example
+ * const metadata = Effect.runSync(clientSchemaMetadataEffect({ type: "string" }));
+ */
+export const clientSchemaMetadataEffect = Effect.fn("Agents.clientSchema.project")(function* (value) {
+    const metadata = yield* Effect.sync(() => {
+        if (isDynamic(value) || isJsonSchemaObject(value))
+            return value;
+        try {
+            return JSON.parse(JSON.stringify(toJsonSchema(value)));
+        }
+        catch {
+            return dynamicClientSchema;
+        }
+    });
+    yield* Metric.update(projectCount, 1);
+    return metadata;
+}, (effect) => observeAgent("client-schema.project", effect));
+/**
+ * Synchronously projects schema metadata for existing descriptor callers.
+ *
+ * @param value - A JSON Schema document or a LangChain-compatible schema.
+ * @returns Projected metadata or the dynamic marker.
+ * @example
+ * const metadata = clientSchemaMetadata({ type: "string" });
+ */
+export function clientSchemaMetadata(value) {
+    return Effect.runSync(clientSchemaMetadataEffect(value));
+}
+function isJsonSchemaObject(value) {
+    if (!isRecord(value) || value.kind === "dynamic")
+        return false;
+    return (["type", "properties", "oneOf", "anyOf", "allOf", "enum", "const", "$ref"].some((key) => Object.hasOwn(value, key)) && isJsonValue(value));
+}
+function schemaProperties(value) {
+    return isRecord(value.properties)
+        ? value.properties
+        : {};
+}
+function schemaRequired(value) {
+    return Array.isArray(value.required)
+        ? value.required.filter((item) => typeof item === "string")
+        : [];
+}
+function isDynamic(value) {
+    return isRecord(value) && value.kind === "dynamic" && Object.keys(value).length === 1;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isJsonValue(value, seen = new Set()) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (typeof value !== "object" || seen.has(value))
+        return false;
+    seen.add(value);
+    const valid = Array.isArray(value)
+        ? value.every((entry) => isJsonValue(entry, seen))
+        : Object.values(value).every((entry) => isJsonValue(entry, seen));
+    seen.delete(value);
+    return valid;
+}
+//# sourceMappingURL=client-contract-schema.js.map

package/dist/client-contract-schema.js.map

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

package/dist/continuation-validation.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Exposes graph identity and continuation validators to transport adapters without
+ * importing the agent execution barrel. Validation remains owned by its existing
+ * implementations and preserves their public failure and reply contracts.
+ */
+export { isGraphDescriptor } from "./define-graph.js";
+export { validateGraphResumeInput } from "./graph-continuation-validation.js";
+export { validateNativeAgentResumeInput } from "./native-agent-interruption.js";
+//# sourceMappingURL=continuation-validation.d.ts.map

package/dist/continuation-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-validation.d.ts","sourceRoot":"","sources":["../src/continuation-validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/continuation-validation.js

@@ -0,0 +1,9 @@
+/**
+ * Exposes graph identity and continuation validators to transport adapters without
+ * importing the agent execution barrel. Validation remains owned by its existing
+ * implementations and preserves their public failure and reply contracts.
+ */
+export { isGraphDescriptor } from "./define-graph.js";
+export { validateGraphResumeInput } from "./graph-continuation-validation.js";
+export { validateNativeAgentResumeInput } from "./native-agent-interruption.js";
+//# sourceMappingURL=continuation-validation.js.map

package/dist/continuation-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-validation.js","sourceRoot":"","sources":["../src/continuation-validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/deepagent-bucket-backend.d.ts

@@ -0,0 +1,33 @@
+/** Adapts a configured RELKIT bucket to the DeepAgents file backend, sharing the invocation scope and preserving bucket failures at the native adapter. */
+import type { BackendProtocolV2 } from "deepagents";
+import { Effect } from "effect";
+import { type DeepAgentBucketClient } from "./deepagent-bucket-files.js";
+import type { DeepAgentBucketBackendOptions } from "./deepagent-bucket-backend.types.js";
+export type { DeepAgentBucketBackendOptions } from "./deepagent-bucket-backend.types.js";
+/** Builds a DeepAgents backend from a RELKIT bucket client.
+ * @param bucket - Bucket client that owns the backend's files.
+ * @param options - Optional key prefix.
+ * @returns An Effect with a frozen backend or DeepAgentBucketFailure.
+ * @example Effect.runSync(createDeepAgentBucketBackendEffect(bucket));
+ */
+export declare const createDeepAgentBucketBackendEffect: (bucket: DeepAgentBucketClient, options?: DeepAgentBucketBackendOptions | undefined) => Effect.Effect<Readonly<{
+    ls: (path: string) => Promise<import("deepagents").LsResult>;
+    read: (path: string, offset?: number, limit?: number) => Promise<import("deepagents").ReadResult>;
+    readRaw: (path: string) => Promise<import("deepagents").ReadRawResult>;
+    write: (path: string, content: string) => Promise<import("deepagents").WriteResult>;
+    edit: (path: string, oldText: string, newText: string, replaceAll?: boolean) => Promise<import("deepagents").EditResult>;
+    grep: (pattern: string, path?: string | null, glob?: string | null, maxCount?: number | null) => Promise<import("deepagents").GrepResult>;
+    glob: (pattern: string, path?: string) => Promise<import("deepagents").GlobResult>;
+    delete: (path: string) => Promise<import("deepagents").DeleteResult>;
+    uploadFiles: (files: Array<[string, Uint8Array]>) => Promise<import("deepagents").FileUploadResponse[]>;
+    downloadFiles: (paths: string[]) => Promise<import("deepagents").FileDownloadResponse[]>;
+}>, import("./deepagent-bucket-error.js").DeepAgentBucketFailure, never>;
+/** Creates a backend for existing synchronous callers.
+ * @param bucket - Bucket client that owns the backend's files.
+ * @param options - Optional key prefix.
+ * @returns A frozen DeepAgents backend.
+ * @throws The original invalid bucket or prefix error.
+ * @example const backend = createDeepAgentBucketBackend(bucket);
+ */
+export declare function createDeepAgentBucketBackend(bucket: DeepAgentBucketClient, options?: DeepAgentBucketBackendOptions): BackendProtocolV2;
+//# sourceMappingURL=deepagent-bucket-backend.d.ts.map

package/dist/deepagent-bucket-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-backend.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-backend.ts"],"names":[],"mappings":"AAAA,2JAA2J;AAE3J,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAS9F,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAEzF,YAAY,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAEzF;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC;eAO9B,MAAM;iBACJ,MAAM,WAAW,MAAM,UAAU,MAAM;oBAEpC,MAAM;kBACR,MAAM,WAAW,MAAM;iBACxB,MAAM,WAAW,MAAM,WAAW,MAAM;oBAG1C,MAAM,SACR,MAAM,GAAG,IAAI,SACb,MAAM,GAAG,IAAI,aACT,MAAM,GAAG,IAAI;oBAEV,MAAM,SAAS,MAAM;mBACtB,MAAM;yBACA,KAAK,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;2BACzB,MAAM,EAAE;wEAIpC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,6BAAkC,GAC1C,iBAAiB,CAMnB"}