@llm4ts/core 0.1.0

package/dist/Connector.js

@@ -0,0 +1,86 @@
+import * as Clock from "effect/Clock";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { CliSandbox } from "./ConnectorConfig.js";
+import { InvalidRequestError } from "./Errors.js";
+import { ConnectorCapabilities, HealthStatus } from "./Models.js";
+import { parseFromText, withSchemaHint } from "./StructuredOutput.js";
+export class CliContext extends Schema.Class("CliContext")({
+    worktreePath: Schema.String,
+    repoPath: Schema.String,
+    envVars: Schema.Record(Schema.String, Schema.String).pipe(Schema.withConstructorDefault(Effect.succeed(Object.freeze({})))),
+    sandbox: Schema.optionalKey(CliSandbox),
+    turnLimit: Schema.optionalKey(Schema.Int)
+}) {
+}
+export const apiConnectorCapabilities = () => ConnectorCapabilities.make({});
+export const timedHealthCheck = (isAvailable) => Effect.gen(function* () {
+    const startedAt = yield* Clock.currentTimeNanos;
+    const available = yield* isAvailable;
+    const completedAt = yield* Clock.currentTimeNanos;
+    return HealthStatus.make({
+        availability: available ? "Healthy" : "Unhealthy",
+        authStatus: available ? "Valid" : "Invalid",
+        latency: Duration.nanos(completedAt - startedAt)
+    });
+});
+export const makeApiConnector = (primitives) => {
+    const executeStructured = (prompt, schema, jsonSchema) => Effect.map(primitives.executeStructuredWithUsage(prompt, schema, jsonSchema), ([value]) => value);
+    return {
+        ...primitives,
+        kind: "Api",
+        capabilities: primitives.capabilities ?? apiConnectorCapabilities(),
+        healthCheck: timedHealthCheck(primitives.isAvailable),
+        executeStructured
+    };
+};
+export const cliConnectorCapabilities = (interactionSupport) => ConnectorCapabilities.make({
+    interactiveSessions: interactionSupport === "InteractiveStdin"
+});
+export const flattenHistory = (messages) => {
+    const systemBlock = messages
+        .filter((message) => message.role === "System" && message.content.length > 0)
+        .map((message) => message.content)
+        .join("\n\n");
+    const turns = messages
+        .filter((message) => message.role !== "System")
+        .map((message) => `**${message.role}:** ${message.content}`)
+        .join("\n\n");
+    return `${systemBlock.length === 0 ? "" : `${systemBlock}\n\n`}${turns}`;
+};
+const cliProbeHealthy = HealthStatus.make({ availability: "Healthy", authStatus: "Valid" });
+const cliProbeUnhealthy = HealthStatus.make({ availability: "Unhealthy", authStatus: "Unknown" });
+export const cliVersionProbeHealthCheck = (probe) => probe.executor
+    .run([probe.binary, ...(probe.versionArgs ?? ["--version"])], probe.cwd ?? ".", {})
+    .pipe(Effect.as(cliProbeHealthy), Effect.catch(() => Effect.succeed(cliProbeUnhealthy)));
+const unsupportedTools = (id, _prompt, _tools) => Effect.fail(InvalidRequestError.make({
+    message: `CLI connector ${id.value} does not support tool calling`
+}));
+export const makeCliConnector = (primitives) => {
+    const executeStructured = (prompt, schema, jsonSchema) => Effect.flatMap(primitives.complete(withSchemaHint(prompt, jsonSchema)), (text) => parseFromText(text, schema, jsonSchema));
+    const executeStructuredWithUsage = (prompt, schema, jsonSchema) => Effect.map(executeStructured(prompt, schema, jsonSchema), (value) => [
+        value,
+        undefined,
+        undefined
+    ]);
+    const healthCheck = primitives.healthCheck ??
+        (primitives.versionProbe === undefined
+            ? Effect.succeed(HealthStatus.make({ availability: "Unknown", authStatus: "Unknown" }))
+            : cliVersionProbeHealthCheck(primitives.versionProbe));
+    const isAvailable = primitives.isAvailable ??
+        healthCheck.pipe(Effect.map((status) => status.availability === "Healthy"), Effect.catch(() => Effect.succeed(false)));
+    return {
+        ...primitives,
+        kind: "Cli",
+        capabilities: primitives.capabilities ?? cliConnectorCapabilities(primitives.interactionSupport),
+        healthCheck,
+        isAvailable,
+        executeStream: primitives.completeStream,
+        executeStreamWithHistory: (messages) => primitives.completeStream(flattenHistory(messages)),
+        executeWithTools: (prompt, tools) => unsupportedTools(primitives.id, prompt, tools),
+        executeStructured,
+        executeStructuredWithUsage
+    };
+};
+//# sourceMappingURL=Connector.js.map

package/dist/Connector.js.map

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

package/dist/ConnectorConfig.d.ts

@@ -0,0 +1,70 @@
+import * as Schema from "effect/Schema";
+import { ConnectorId, LlmConfig } from "./Models.ts";
+declare const DockerSandbox_base: Schema.Class<DockerSandbox, Schema.TaggedStruct<"Docker", {
+    readonly image: Schema.String;
+    readonly mount: Schema.withConstructorDefault<Schema.Boolean>;
+    readonly network: Schema.optionalKey<Schema.String>;
+}>, {}>;
+export declare class DockerSandbox extends DockerSandbox_base {
+}
+declare const PodmanSandbox_base: Schema.Class<PodmanSandbox, Schema.TaggedStruct<"Podman", {}>, {}>;
+export declare class PodmanSandbox extends PodmanSandbox_base {
+}
+declare const SeatbeltMacOsSandbox_base: Schema.Class<SeatbeltMacOsSandbox, Schema.TaggedStruct<"SeatbeltMacOS", {}>, {}>;
+export declare class SeatbeltMacOsSandbox extends SeatbeltMacOsSandbox_base {
+}
+declare const RunscSandbox_base: Schema.Class<RunscSandbox, Schema.TaggedStruct<"Runsc", {}>, {}>;
+export declare class RunscSandbox extends RunscSandbox_base {
+}
+declare const LxcSandbox_base: Schema.Class<LxcSandbox, Schema.TaggedStruct<"Lxc", {}>, {}>;
+export declare class LxcSandbox extends LxcSandbox_base {
+}
+export declare const CliSandbox: Schema.Union<readonly [typeof DockerSandbox, typeof PodmanSandbox, typeof SeatbeltMacOsSandbox, typeof RunscSandbox, typeof LxcSandbox]>;
+export type CliSandbox = typeof CliSandbox.Type;
+declare const ApiConnectorConfig_base: Schema.Class<ApiConnectorConfig, Schema.TaggedStruct<"ApiConnectorConfig", {
+    readonly connectorId: typeof ConnectorId;
+    readonly model: Schema.optionalKey<Schema.String>;
+    readonly baseUrl: Schema.optionalKey<Schema.String>;
+    readonly apiKey: Schema.optionalKey<Schema.Redacted<Schema.String>>;
+    readonly timeout: Schema.withConstructorDefault<Schema.Duration>;
+    readonly maxRetries: Schema.withConstructorDefault<Schema.Int>;
+    readonly requestsPerMinute: Schema.withConstructorDefault<Schema.Int>;
+    readonly burstSize: Schema.withConstructorDefault<Schema.Int>;
+    readonly acquireTimeout: Schema.withConstructorDefault<Schema.Duration>;
+    readonly temperature: Schema.optionalKey<Schema.Number>;
+    readonly maxTokens: Schema.optionalKey<Schema.Int>;
+}>, {}>;
+export declare class ApiConnectorConfig extends ApiConnectorConfig_base {
+}
+declare const CliConnectorConfig_base: Schema.Class<CliConnectorConfig, Schema.TaggedStruct<"CliConnectorConfig", {
+    readonly connectorId: typeof ConnectorId;
+    readonly model: Schema.optionalKey<Schema.String>;
+    readonly timeout: Schema.withConstructorDefault<Schema.Duration>;
+    readonly maxRetries: Schema.withConstructorDefault<Schema.Int>;
+    readonly flags: Schema.withConstructorDefault<Schema.$Record<Schema.String, Schema.String>>;
+    readonly sandbox: Schema.optionalKey<Schema.Union<readonly [typeof DockerSandbox, typeof PodmanSandbox, typeof SeatbeltMacOsSandbox, typeof RunscSandbox, typeof LxcSandbox]>>;
+    readonly turnLimit: Schema.optionalKey<Schema.Int>;
+    readonly envVars: Schema.withConstructorDefault<Schema.$Record<Schema.String, Schema.String>>;
+    readonly workingDir: Schema.optionalKey<Schema.String>;
+    readonly readOnly: Schema.withConstructorDefault<Schema.Boolean>;
+}>, {}>;
+export declare class CliConnectorConfig extends CliConnectorConfig_base {
+}
+export declare const ConnectorConfig: Schema.Union<readonly [typeof ApiConnectorConfig, typeof CliConnectorConfig]>;
+export type ConnectorConfig = typeof ConnectorConfig.Type;
+export declare const toLlmConfig: (config: ApiConnectorConfig) => LlmConfig;
+declare const FallbackChain_base: Schema.Class<FallbackChain, Schema.Struct<{
+    readonly connectors: Schema.withConstructorDefault<Schema.$Array<Schema.Union<readonly [typeof ApiConnectorConfig, typeof CliConnectorConfig]>>>;
+}>, {}>;
+export declare class FallbackChain extends FallbackChain_base {
+    get isEmpty(): boolean;
+    get nonEmpty(): boolean;
+}
+export declare const emptyFallbackChain: FallbackChain;
+export declare const defaultCliConnectorConfigs: Readonly<{
+    Claude: CliConnectorConfig;
+    Codex: CliConnectorConfig;
+}>;
+export declare const defaultReasoningConfig: (coder: ConnectorConfig, explicit?: ConnectorConfig) => ConnectorConfig;
+export {};
+//# sourceMappingURL=ConnectorConfig.d.ts.map

package/dist/ConnectorConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorConfig.d.ts","sourceRoot":"","sources":["../src/ConnectorConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,WAAW,EAAgB,SAAS,EAAoB,MAAM,aAAa,CAAA;;;;;;AAEpF,qBAAa,aAAc,SAAQ,kBAIjC;CAAG;;AAEL,qBAAa,aAAc,SAAQ,kBAAiD;CAAG;;AACvF,qBAAa,oBAAqB,SAAQ,yBAGzC;CAAG;;AACJ,qBAAa,YAAa,SAAQ,iBAA+C;CAAG;;AACpF,qBAAa,UAAW,SAAQ,eAA2C;CAAG;AAE9E,eAAO,MAAM,UAAU,0IAMrB,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;;;;;;;;;;;;;;AAI/C,qBAAa,kBAAmB,SAAQ,uBAuBvC;CAAG;;;;;;;;;;;;;AAEJ,qBAAa,kBAAmB,SAAQ,uBAoBvC;CAAG;AAEJ,eAAO,MAAM,eAAe,+EAAyD,CAAA;AACrF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAmBzD,eAAO,MAAM,WAAW,GAAI,QAAQ,kBAAkB,KAAG,SAarD,CAAA;;;;AAIJ,qBAAa,aAAc,SAAQ,kBAIjC;IACA,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF;AAED,eAAO,MAAM,kBAAkB,eAAsB,CAAA;AAErD,eAAO,MAAM,0BAA0B;;;EAGrC,CAAA;AAEF,eAAO,MAAM,sBAAsB,GACjC,OAAO,eAAe,EACtB,WAAW,eAAe,KACzB,eAOF,CAAA"}

package/dist/ConnectorConfig.js

@@ -0,0 +1,110 @@
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { ConnectorId, ConnectorIds, LlmConfig } from "./Models.js";
+export class DockerSandbox extends Schema.TaggedClass()("Docker", {
+    image: Schema.String,
+    mount: Schema.Boolean.pipe(Schema.withConstructorDefault(Effect.succeed(true))),
+    network: Schema.optionalKey(Schema.String)
+}) {
+}
+export class PodmanSandbox extends Schema.TaggedClass()("Podman", {}) {
+}
+export class SeatbeltMacOsSandbox extends Schema.TaggedClass()("SeatbeltMacOS", {}) {
+}
+export class RunscSandbox extends Schema.TaggedClass()("Runsc", {}) {
+}
+export class LxcSandbox extends Schema.TaggedClass()("Lxc", {}) {
+}
+export const CliSandbox = Schema.Union([
+    DockerSandbox,
+    PodmanSandbox,
+    SeatbeltMacOsSandbox,
+    RunscSandbox,
+    LxcSandbox
+]);
+const emptyStringRecord = Object.freeze({});
+export class ApiConnectorConfig extends Schema.TaggedClass()("ApiConnectorConfig", {
+    connectorId: ConnectorId,
+    model: Schema.optionalKey(Schema.String),
+    baseUrl: Schema.optionalKey(Schema.String),
+    apiKey: Schema.optionalKey(Schema.Redacted(Schema.String, {
+        disallowJsonEncode: true
+    })),
+    timeout: Schema.Duration.pipe(Schema.withConstructorDefault(Effect.succeed(Duration.seconds(300)))),
+    maxRetries: Schema.Int.pipe(Schema.withConstructorDefault(Effect.succeed(3))),
+    requestsPerMinute: Schema.Int.pipe(Schema.withConstructorDefault(Effect.succeed(60))),
+    burstSize: Schema.Int.pipe(Schema.withConstructorDefault(Effect.succeed(10))),
+    acquireTimeout: Schema.Duration.pipe(Schema.withConstructorDefault(Effect.succeed(Duration.seconds(30)))),
+    temperature: Schema.optionalKey(Schema.Number),
+    maxTokens: Schema.optionalKey(Schema.Int)
+}) {
+}
+export class CliConnectorConfig extends Schema.TaggedClass()("CliConnectorConfig", {
+    connectorId: ConnectorId,
+    model: Schema.optionalKey(Schema.String),
+    timeout: Schema.Duration.pipe(Schema.withConstructorDefault(Effect.succeed(Duration.seconds(300)))),
+    maxRetries: Schema.Int.pipe(Schema.withConstructorDefault(Effect.succeed(3))),
+    flags: Schema.Record(Schema.String, Schema.String).pipe(Schema.withConstructorDefault(Effect.succeed(emptyStringRecord))),
+    sandbox: Schema.optionalKey(CliSandbox),
+    turnLimit: Schema.optionalKey(Schema.Int),
+    envVars: Schema.Record(Schema.String, Schema.String).pipe(Schema.withConstructorDefault(Effect.succeed(emptyStringRecord))),
+    workingDir: Schema.optionalKey(Schema.String),
+    readOnly: Schema.Boolean.pipe(Schema.withConstructorDefault(Effect.succeed(false)))
+}) {
+}
+export const ConnectorConfig = Schema.Union([ApiConnectorConfig, CliConnectorConfig]);
+const providerForConnector = (connectorId) => {
+    switch (connectorId.value) {
+        case "anthropic":
+            return "Anthropic";
+        case "gemini-api":
+            return "GeminiApi";
+        case "lm-studio":
+            return "LmStudio";
+        case "ollama":
+            return "Ollama";
+        case "mock":
+            return "Mock";
+        default:
+            return "OpenAI";
+    }
+};
+export const toLlmConfig = (config) => new LlmConfig({
+    provider: providerForConnector(config.connectorId),
+    model: config.model ?? "",
+    timeout: config.timeout,
+    maxRetries: config.maxRetries,
+    requestsPerMinute: config.requestsPerMinute,
+    burstSize: config.burstSize,
+    acquireTimeout: config.acquireTimeout,
+    ...(config.baseUrl === undefined ? {} : { baseUrl: config.baseUrl }),
+    ...(config.apiKey === undefined ? {} : { apiKey: config.apiKey }),
+    ...(config.temperature === undefined ? {} : { temperature: config.temperature }),
+    ...(config.maxTokens === undefined ? {} : { maxTokens: config.maxTokens })
+});
+const emptyConnectors = Object.freeze([]);
+export class FallbackChain extends Schema.Class("FallbackChain")({
+    connectors: Schema.Array(ConnectorConfig).pipe(Schema.withConstructorDefault(Effect.succeed(emptyConnectors)))
+}) {
+    get isEmpty() {
+        return this.connectors.length === 0;
+    }
+    get nonEmpty() {
+        return this.connectors.length > 0;
+    }
+}
+export const emptyFallbackChain = new FallbackChain();
+export const defaultCliConnectorConfigs = Object.freeze({
+    Claude: new CliConnectorConfig({ connectorId: ConnectorIds.ClaudeCli }),
+    Codex: new CliConnectorConfig({ connectorId: ConnectorIds.Codex })
+});
+export const defaultReasoningConfig = (coder, explicit) => {
+    if (explicit !== undefined) {
+        return explicit;
+    }
+    return coder instanceof CliConnectorConfig
+        ? CliConnectorConfig.make({ ...coder, readOnly: true })
+        : coder;
+};
+//# sourceMappingURL=ConnectorConfig.js.map

package/dist/ConnectorConfig.js.map

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

package/dist/ConnectorRegistry.d.ts

@@ -0,0 +1,28 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import type { ApiConnectorConfig, CliConnectorConfig, ConnectorConfig, FallbackChain } from "./ConnectorConfig.ts";
+import type { ApiConnectorShape, CliConnectorShape, ConnectorShape } from "./Connector.ts";
+import { type LlmError } from "./Errors.ts";
+import { HealthStatus, type ConnectorId, type ConnectorKind } from "./Models.ts";
+export interface ConnectorFactory {
+    readonly connectorId: ConnectorId;
+    readonly kind: ConnectorKind;
+    readonly create: (config: ConnectorConfig) => Effect.Effect<ConnectorShape, LlmError>;
+}
+export interface ConnectorRegistryShape {
+    readonly resolve: (config: ConnectorConfig) => Effect.Effect<ConnectorShape, LlmError>;
+    readonly resolveApi: (config: ApiConnectorConfig) => Effect.Effect<ApiConnectorShape, LlmError>;
+    readonly resolveCli: (config: CliConnectorConfig) => Effect.Effect<CliConnectorShape, LlmError>;
+    readonly resolveFallback: (chain: FallbackChain) => Effect.Effect<ConnectorShape, LlmError>;
+    readonly available: Effect.Effect<ReadonlyArray<ConnectorId>>;
+    readonly healthCheckAll: Effect.Effect<ReadonlyMap<ConnectorId, HealthStatus>>;
+}
+declare const ConnectorRegistry_base: Context.ServiceClass<ConnectorRegistry, "@llm4ts/core/ConnectorRegistry", ConnectorRegistryShape>;
+export declare class ConnectorRegistry extends ConnectorRegistry_base {
+}
+export declare const makeConnectorRegistry: (factories: Iterable<ConnectorFactory>) => ConnectorRegistryShape;
+export declare const resolveConnector: (config: ConnectorConfig) => Effect.Effect<ConnectorShape, LlmError, ConnectorRegistry>;
+export declare const resolveApiConnector: (config: ApiConnectorConfig) => Effect.Effect<ApiConnectorShape, LlmError, ConnectorRegistry>;
+export declare const resolveCliConnector: (config: CliConnectorConfig) => Effect.Effect<CliConnectorShape, LlmError, ConnectorRegistry>;
+export {};
+//# sourceMappingURL=ConnectorRegistry.d.ts.map

package/dist/ConnectorRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorRegistry.d.ts","sourceRoot":"","sources":["../src/ConnectorRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACd,MAAM,sBAAsB,CAAA;AAK7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC1F,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;CACtF;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;IACtF,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAA;IAC/F,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAA;IAC/F,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;IAC3F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAA;IAC7D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAA;CAC/E;;AAED,qBAAa,iBAAkB,SAAQ,sBAEtC;CAAG;AAwBJ,eAAO,MAAM,qBAAqB,GAChC,WAAW,QAAQ,CAAC,gBAAgB,CAAC,KACpC,sBA6GF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,eAAe,KACtB,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,iBAAiB,CACe,CAAA;AAE3E,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,kBAAkB,KACzB,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,CACe,CAAA;AAE9E,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,kBAAkB,KACzB,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,CACe,CAAA"}

package/dist/ConnectorRegistry.js

@@ -0,0 +1,87 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import { ApiConnectorConfig as ApiConfig, CliConnectorConfig as CliConfig } from "./ConnectorConfig.js";
+import { ConfigError } from "./Errors.js";
+import { HealthStatus } from "./Models.js";
+export class ConnectorRegistry extends Context.Service()("@llm4ts/core/ConnectorRegistry") {
+}
+const unknownHealth = () => HealthStatus.make({
+    availability: "Unknown",
+    authStatus: "Unknown"
+});
+const isApiConnector = (connector) => connector.kind === "Api";
+const isCliConnector = (connector) => connector.kind === "Cli" &&
+    "interactionSupport" in connector &&
+    "buildArgv" in connector &&
+    "buildInteractiveArgv" in connector &&
+    "complete" in connector &&
+    "completeStream" in connector;
+const healthEntry = (id, status) => [id, status];
+export const makeConnectorRegistry = (factories) => {
+    const byId = new Map();
+    for (const factory of factories) {
+        byId.set(factory.connectorId.value, factory);
+    }
+    const resolve = (config) => {
+        const factory = byId.get(config.connectorId.value);
+        return factory === undefined
+            ? Effect.fail(ConfigError.make({
+                message: `Unknown connector: ${config.connectorId.value}`
+            }))
+            : factory.create(config);
+    };
+    const resolveApi = (config) => Effect.flatMap(resolve(config), (connector) => isApiConnector(connector)
+        ? Effect.succeed(connector)
+        : Effect.fail(ConfigError.make({
+            message: `Expected ApiConnector, got ${connector.kind}`
+        })));
+    const resolveCli = (config) => Effect.flatMap(resolve(config), (connector) => isCliConnector(connector)
+        ? Effect.succeed(connector)
+        : Effect.fail(ConfigError.make({
+            message: `Expected CliConnector, got ${connector.kind}`
+        })));
+    const resolveFallback = (chain) => {
+        const loop = (remaining, failures) => {
+            const [config, ...tail] = remaining;
+            if (config === undefined) {
+                return Effect.fail(ConfigError.make({
+                    message: failures.length === 0
+                        ? "Fallback chain is empty"
+                        : `No fallback connector is available: ${failures.join("; ")}`
+                }));
+            }
+            return Effect.result(Effect.flatMap(resolve(config), (connector) => Effect.map(connector.isAvailable, (available) => ({
+                connector,
+                available
+            })))).pipe(Effect.flatMap((result) => {
+                if (result._tag === "Success" && result.success.available) {
+                    return Effect.succeed(result.success.connector);
+                }
+                const reason = result._tag === "Failure"
+                    ? `${config.connectorId.value}: ${result.failure.message}`
+                    : `${config.connectorId.value}: unavailable`;
+                return Effect.suspend(() => loop(tail, [...failures, reason]));
+            }));
+        };
+        return loop(chain.connectors, []);
+    };
+    const available = Effect.sync(() => Array.from(byId.values(), (factory) => factory.connectorId));
+    const healthCheckAll = Effect.forEach(Array.from(byId.values()), (factory) => {
+        const defaultConfig = factory.kind === "Api"
+            ? ApiConfig.make({ connectorId: factory.connectorId })
+            : CliConfig.make({ connectorId: factory.connectorId });
+        return Effect.result(Effect.flatMap(factory.create(defaultConfig), (connector) => connector.healthCheck)).pipe(Effect.map((result) => healthEntry(factory.connectorId, result._tag === "Success" ? result.success : unknownHealth())));
+    }).pipe(Effect.map((entries) => new Map(entries)));
+    return {
+        resolve,
+        resolveApi,
+        resolveCli,
+        resolveFallback,
+        available,
+        healthCheckAll
+    };
+};
+export const resolveConnector = (config) => Effect.flatMap(ConnectorRegistry, (registry) => registry.resolve(config));
+export const resolveApiConnector = (config) => Effect.flatMap(ConnectorRegistry, (registry) => registry.resolveApi(config));
+export const resolveCliConnector = (config) => Effect.flatMap(ConnectorRegistry, (registry) => registry.resolveCli(config));
+//# sourceMappingURL=ConnectorRegistry.js.map

package/dist/ConnectorRegistry.js.map

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

package/dist/ContextManagement.d.ts

@@ -0,0 +1,78 @@
+import * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { ConversationMessage } from "./Conversation.ts";
+import type { LlmProvider } from "./Models.ts";
+declare const ContextInvalidInput_base: Schema.Class<ContextInvalidInput, Schema.TaggedStruct<"InvalidInput", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ContextInvalidInput extends ContextInvalidInput_base {
+}
+declare const ContextParseFailed_base: Schema.Class<ContextParseFailed, Schema.TaggedStruct<"ParseFailed", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ContextParseFailed extends ContextParseFailed_base {
+}
+declare const ContextSummarizationFailed_base: Schema.Class<ContextSummarizationFailed, Schema.TaggedStruct<"SummarizationFailed", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ContextSummarizationFailed extends ContextSummarizationFailed_base {
+}
+declare const ContextToolLoopFailed_base: Schema.Class<ContextToolLoopFailed, Schema.TaggedStruct<"ToolLoopFailed", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ContextToolLoopFailed extends ContextToolLoopFailed_base {
+}
+export declare const ContextError: Schema.Union<readonly [typeof ContextInvalidInput, typeof ContextParseFailed, typeof ContextSummarizationFailed, typeof ContextToolLoopFailed]>;
+export type ContextError = typeof ContextError.Type;
+declare const ContextLimits_base: Schema.Class<ContextLimits, Schema.Struct<{
+    readonly maxTokens: Schema.Int;
+    readonly warningThresholdPct: Schema.withConstructorDefault<Schema.Number>;
+}>, {}>;
+export declare class ContextLimits extends ContextLimits_base {
+}
+declare const ContextWindow_base: Schema.Class<ContextWindow, Schema.Struct<{
+    readonly messages: Schema.$Array<typeof ConversationMessage>;
+    readonly totalTokens: Schema.Int;
+    readonly approachingLimit: Schema.Boolean;
+    readonly trimmed: Schema.Boolean;
+}>, {}>;
+export declare class ContextWindow extends ContextWindow_base {
+}
+declare const DropOldestFifo_base: Schema.Class<DropOldestFifo, Schema.TaggedStruct<"DropOldestFifo", {}>, {}>;
+export declare class DropOldestFifo extends DropOldestFifo_base {
+}
+declare const SlidingWindow_base: Schema.Class<SlidingWindow, Schema.TaggedStruct<"SlidingWindow", {}>, {}>;
+export declare class SlidingWindow extends SlidingWindow_base {
+}
+declare const PriorityBased_base: Schema.Class<PriorityBased, Schema.TaggedStruct<"PriorityBased", {}>, {}>;
+export declare class PriorityBased extends PriorityBased_base {
+}
+declare const SummarizeOldMessages_base: Schema.Class<SummarizeOldMessages, Schema.TaggedStruct<"SummarizeOldMessages", {
+    readonly summaryTargetTokens: Schema.withConstructorDefault<Schema.Int>;
+}>, {}>;
+export declare class SummarizeOldMessages extends SummarizeOldMessages_base {
+}
+export declare const ContextTrimmingStrategy: Schema.Union<readonly [typeof DropOldestFifo, typeof SlidingWindow, typeof PriorityBased, typeof SummarizeOldMessages]>;
+export type ContextTrimmingStrategy = typeof ContextTrimmingStrategy.Type;
+export declare const ContextTrimmingStrategies: Readonly<{
+    DropOldestFifo: DropOldestFifo;
+    SlidingWindow: SlidingWindow;
+    PriorityBased: PriorityBased;
+    SummarizeOldMessages: (summaryTargetTokens?: number) => SummarizeOldMessages;
+}>;
+export interface TokenCounter {
+    readonly countText: (provider: LlmProvider, text: string) => number;
+    readonly countMessage: (provider: LlmProvider, message: ConversationMessage) => number;
+    readonly countMessages: (provider: LlmProvider, messages: Iterable<ConversationMessage>) => number;
+}
+export declare const defaultTokenCounter: TokenCounter;
+export interface MessageSummarizer<R = never> {
+    readonly summarize: (messages: ReadonlyArray<ConversationMessage>, targetTokens: number) => Effect.Effect<ConversationMessage, ContextError, R>;
+}
+export declare const simpleMessageSummarizer: MessageSummarizer<Crypto.Crypto>;
+export declare function applyContextWindow(messages: ReadonlyArray<ConversationMessage>, provider: LlmProvider, limits: ContextLimits, strategy: DropOldestFifo | SlidingWindow | PriorityBased, tokenCounter?: TokenCounter): Effect.Effect<ContextWindow, ContextError>;
+export declare function applyContextWindow(messages: ReadonlyArray<ConversationMessage>, provider: LlmProvider, limits: ContextLimits, strategy: ContextTrimmingStrategy, tokenCounter?: TokenCounter): Effect.Effect<ContextWindow, ContextError, Crypto.Crypto>;
+export declare function applyContextWindow<R>(messages: ReadonlyArray<ConversationMessage>, provider: LlmProvider, limits: ContextLimits, strategy: ContextTrimmingStrategy, tokenCounter: TokenCounter, summarizer: MessageSummarizer<R>): Effect.Effect<ContextWindow, ContextError, R>;
+export {};
+//# sourceMappingURL=ContextManagement.d.ts.map

package/dist/ContextManagement.d.ts.map

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