@voltro/ai 0.84.0 → 0.85.0

package/THIRD-PARTY-NOTICES.md

@@ -5,7 +5,7 @@ property of its respective copyright holders and is used under the terms of
 its license. This file is provided for attribution; it grants no rights in
 @voltro/ai itself, which is proprietary (see LICENSE).
 
-Generated from the resolved runtime dependency closure (37 packages).
+Generated from the resolved runtime dependency closure (32 packages).
 
 ---
 
@@ -75,118 +75,6 @@ License: Apache-2.0
 
 _(no bundled license text found in the package; see its npm page.)_
 
-## @effect/cluster@0.60.2
-
-License: MIT
-
-```
-MIT License
-
-Copyright (c) 2023-present The Contributors
-
-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.
-```
-
-## @effect/experimental@0.61.1
-
-License: MIT
-
-```
-MIT License
-
-Copyright (c) 2023-present The Contributors
-
-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.
-```
-
-## @effect/sql@0.52.1
-
-License: MIT
-
-```
-MIT License
-
-Copyright (c) 2023-present The Contributors
-
-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.
-```
-
-## @effect/workflow@0.19.1
-
-License: MIT
-
-```
-MIT License
-
-Copyright (c) 2023-present The Contributors
-
-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.
-```
-
 ## @ioredis/commands@1.10.0
 
 License: MIT
@@ -971,12 +859,6 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## kubernetes-types@1.30.0
-
-License: Apache-2.0
-
-_(no bundled license text found in the package; see its npm page.)_
-
 ## layerr@3.0.0
 
 License: MIT

package/dist/agent.d.ts

@@ -2,6 +2,7 @@ import { ActionProcedureDescriptor } from '@voltro/protocol';
 import { Guards } from '@voltro/protocol';
 import { QueryProcedureDescriptor } from '@voltro/protocol';
 import { Schema } from 'effect';
+import { YieldableError } from 'effect/Cause';
 
 declare const AGENT_DESCRIPTOR_BRAND: "@voltro/ai/AgentDescriptor";
 
@@ -30,7 +31,7 @@ export declare interface AgentAccessOptions {
     readonly openAccess?: string;
 }
 
-export declare interface AgentDescriptor<S extends Schema.Schema.Any = DefaultAgentInputSchema> {
+export declare interface AgentDescriptor<S extends Schema.Top = DefaultAgentInputSchema> {
     readonly _brand: typeof AGENT_DESCRIPTOR_BRAND;
     /** Wire id → rpc tags `<name>.send` / `<name>.messages`. */
     readonly name: string;
@@ -43,25 +44,22 @@ export declare interface AgentDescriptor<S extends Schema.Schema.Any = DefaultAg
 }
 
 /** The decoded input an agent's executor sees, derived from its schema. */
-export declare type AgentInput<S extends Schema.Schema.Any> = Schema.Schema.Type<S>;
+export declare type AgentInput<S extends Schema.Top> = Schema.Schema.Type<S>;
 
 /** The agent's input schema (default `{ prompt: string }`). */
-export declare const agentInputSchema: (desc: AnyAgentDescriptor) => Schema.Schema.Any;
+export declare const agentInputSchema: (desc: AnyAgentDescriptor) => Schema.Top;
 
 export declare const agentMessageSchema: Schema.Struct<{
-    id: typeof Schema.String;
-    threadId: typeof Schema.String;
-    role: typeof Schema.String;
-    content: typeof Schema.String;
-    streaming: typeof Schema.Boolean;
-    order: typeof Schema.Number;
-    stepOrder: typeof Schema.Number;
-    parts: Schema.Array$<Schema.TypeLiteral<{
-        type: typeof Schema.String;
-    }, readonly [{
-        readonly key: typeof Schema.String;
-        readonly value: typeof Schema.Unknown;
-    }]>>;
+    readonly id: Schema.String;
+    readonly threadId: Schema.String;
+    readonly role: Schema.String;
+    readonly content: Schema.String;
+    readonly streaming: Schema.Boolean;
+    readonly order: Schema.Number;
+    readonly stepOrder: Schema.Number;
+    readonly parts: Schema.$Array<Schema.StructWithRest<Schema.Struct<{
+        readonly type: Schema.String;
+    }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>>;
 }>;
 
 /**
@@ -70,25 +68,22 @@ export declare const agentMessageSchema: Schema.Struct<{
  * so "what the server serves" and "what the client is typed for" can't drift.
  */
 export declare const agentRouteDescriptors: (desc: AnyAgentDescriptor) => {
-    send: ActionProcedureDescriptor<`${string}.send`, Schema.Schema.Any, Schema.Struct<{
-        text: typeof Schema.String;
+    send: ActionProcedureDescriptor<`${string}.send`, Schema.Top, Schema.Struct<{
+        readonly text: Schema.String;
     }>, typeof AgentThreadAccessDenied>;
     messages: QueryProcedureDescriptor<`${string}.messages`, Schema.Struct<{
-        threadId: typeof Schema.String;
-    }>, Schema.Array$<Schema.Struct<{
-        id: typeof Schema.String;
-        threadId: typeof Schema.String;
-        role: typeof Schema.String;
-        content: typeof Schema.String;
-        streaming: typeof Schema.Boolean;
-        order: typeof Schema.Number;
-        stepOrder: typeof Schema.Number;
-        parts: Schema.Array$<Schema.TypeLiteral<{
-            type: typeof Schema.String;
-        }, readonly [{
-            readonly key: typeof Schema.String;
-            readonly value: typeof Schema.Unknown;
-        }]>>;
+        readonly threadId: Schema.String;
+    }>, Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly threadId: Schema.String;
+        readonly role: Schema.String;
+        readonly content: Schema.String;
+        readonly streaming: Schema.Boolean;
+        readonly order: Schema.Number;
+        readonly stepOrder: Schema.Number;
+        readonly parts: Schema.$Array<Schema.StructWithRest<Schema.Struct<{
+            readonly type: Schema.String;
+        }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>>;
     }>>, typeof AgentThreadAccessDenied>;
 };
 
@@ -108,17 +103,15 @@ export declare class AgentThreadAccessDenied extends AgentThreadAccessDenied_bas
     get message(): string;
 }
 
-declare const AgentThreadAccessDenied_base: Schema.TaggedErrorClass<AgentThreadAccessDenied, "AgentThreadAccessDenied", {
-    readonly _tag: Schema.tag<"AgentThreadAccessDenied">;
-} & {
-    threadId: typeof Schema.String;
-}>;
+declare const AgentThreadAccessDenied_base: Schema.Class<AgentThreadAccessDenied, Schema.TaggedStruct<"AgentThreadAccessDenied", {
+    readonly threadId: Schema.String;
+}>, YieldableError>;
 
 /** A descriptor of any input shape — for the type-erased runtime helpers. */
-export declare type AnyAgentDescriptor = AgentDescriptor<Schema.Schema.Any>;
+export declare type AnyAgentDescriptor = AgentDescriptor<Schema.Top>;
 
 declare const DEFAULT_INPUT: Schema.Struct<{
-    prompt: typeof Schema.String;
+    readonly prompt: Schema.String;
 }>;
 
 /** Default input schema type when `input` is omitted (`{ prompt: string }`). */
@@ -138,7 +131,7 @@ export declare type DefaultAgentInputSchema = typeof DEFAULT_INPUT;
  * })
  * ```
  */
-export declare const defineAgent: <S extends Schema.Schema.Any = DefaultAgentInputSchema>(config: {
+export declare const defineAgent: <S extends Schema.Top = DefaultAgentInputSchema>(config: {
     readonly name: string;
     readonly input?: S;
 } & AgentAccessOptions) => AgentDescriptor<S>;

package/dist/agent.js

@@ -1,2 +1,2 @@
-import { a as e, i as t, n, o as r, r as i, t as a } from "./agentDescriptor-DuxvWGDi.js";
+import { a as e, i as t, n, o as r, r as i, t as a } from "./agentDescriptor-DhoiXVqO.js";
 export { a as AgentThreadAccessDenied, n as agentInputSchema, i as agentMessageSchema, t as agentRouteDescriptors, e as defineAgent, r as isAgentDescriptor };

package/dist/{agentDescriptor-DuxvWGDi.js → agentDescriptor-DhoiXVqO.js}

@@ -17,10 +17,7 @@ var r = "_voltro_agent_threads", i = "_voltro_agent_messages", a = e.Struct({ pr
 		...e.guards === void 0 ? {} : { guards: e.guards },
 		...e.openAccess === void 0 ? {} : { openAccess: e.openAccess }
 	};
-}, l = (e) => typeof e == "object" && !!e && e._brand === o, u = (e) => e.input ?? a, d = e.Struct({ type: e.String }, {
-	key: e.String,
-	value: e.Unknown
-}), f = e.Struct({
+}, l = (e) => typeof e == "object" && !!e && e._brand === o, u = (e) => e.input ?? a, d = e.StructWithRest(e.Struct({ type: e.String }), [e.Record(e.String, e.Unknown)]), f = e.Struct({
 	id: e.String,
 	threadId: e.String,
 	role: e.String,
@@ -35,7 +32,10 @@ var r = "_voltro_agent_threads", i = "_voltro_agent_messages", a = e.Struct({ pr
 		order: e.Number
 	});
 	try {
-		return e.extend(n, r);
+		return e.Struct({
+			...n.fields,
+			...r.fields
+		});
 	} catch {
 		return r;
 	}

package/dist/agentEvent-Bl4egdM5.js

@@ -0,0 +1,211 @@
+import { Schema as e } from "effect";
+//#region src/transcriptionEvent.ts
+var t = class extends e.TaggedError()("TranscriptionStreamError", {
+	reason: e.Literals([
+		"input",
+		"unsupported",
+		"provider",
+		"cancelled"
+	]),
+	message: e.String
+}) {}, n = e.Struct({
+	text: e.String,
+	start: e.Number,
+	end: e.Number
+}), r = { id: e.optional(e.String) }, i = e.Union([
+	e.Struct({
+		type: e.Literal("transcript-delta"),
+		...r,
+		delta: e.String
+	}),
+	e.Struct({
+		type: e.Literal("transcript-partial"),
+		...r,
+		text: e.String,
+		startSecond: e.optional(e.Number),
+		durationInSeconds: e.optional(e.Number),
+		channelIndex: e.optional(e.Number)
+	}),
+	e.Struct({
+		type: e.Literal("transcript-final"),
+		...r,
+		text: e.String,
+		startSecond: e.optional(e.Number),
+		endSecond: e.optional(e.Number),
+		channelIndex: e.optional(e.Number)
+	}),
+	e.Struct({
+		type: e.Literal("finish"),
+		text: e.String,
+		segments: e.Array(n),
+		language: e.optional(e.String),
+		durationSec: e.optional(e.Number)
+	})
+]), a = e.String.pipe(e.check(e.isPattern(/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/))), o = e.Number.pipe(e.check(e.isFinite()), e.check(e.isGreaterThanOrEqualTo(0))), s = e.Union([
+	e.Struct({
+		type: e.Literal("input-audio-append"),
+		audio: a
+	}),
+	e.Struct({ type: e.Literals([
+		"input-audio-commit",
+		"input-audio-clear",
+		"response-create",
+		"response-cancel"
+	]) }),
+	e.Struct({
+		type: e.Literal("conversation-item-create"),
+		item: e.Struct({
+			type: e.Literal("text-message"),
+			role: e.Literal("user"),
+			text: e.String
+		})
+	}),
+	e.Struct({
+		type: e.Literal("conversation-item-truncate"),
+		itemId: e.String,
+		contentIndex: o.pipe(e.check(e.isInt())),
+		audioEndMs: o
+	})
+]), c = { itemId: e.String }, l = {
+	responseId: e.String,
+	...c
+}, u = e.Union([
+	e.Struct({ type: e.Literal("ready") }),
+	e.Struct({
+		type: e.Literal("session-created"),
+		sessionId: e.optional(e.String)
+	}),
+	e.Struct({ type: e.Literal("session-updated") }),
+	e.Struct({
+		type: e.Literals(["speech-started", "speech-stopped"]),
+		itemId: e.optional(e.String)
+	}),
+	e.Struct({
+		type: e.Literal("audio-committed"),
+		itemId: e.optional(e.String),
+		previousItemId: e.optional(e.String)
+	}),
+	e.Struct({
+		type: e.Literal("conversation-item-added"),
+		...c
+	}),
+	e.Struct({
+		type: e.Literal("input-transcription-completed"),
+		...c,
+		transcript: e.String
+	}),
+	e.Struct({
+		type: e.Literal("response-created"),
+		responseId: e.String
+	}),
+	e.Struct({
+		type: e.Literal("response-done"),
+		responseId: e.String,
+		status: e.String
+	}),
+	e.Struct({
+		type: e.Literals([
+			"output-item-added",
+			"output-item-done",
+			"content-part-added",
+			"content-part-done",
+			"audio-done"
+		]),
+		...l
+	}),
+	e.Struct({
+		type: e.Literal("audio-delta"),
+		...l,
+		delta: a
+	}),
+	e.Struct({
+		type: e.Literals(["text-delta", "audio-transcript-delta"]),
+		...l,
+		delta: e.String
+	}),
+	e.Struct({
+		type: e.Literal("text-done"),
+		...l,
+		text: e.optional(e.String)
+	}),
+	e.Struct({
+		type: e.Literal("audio-transcript-done"),
+		...l,
+		transcript: e.optional(e.String)
+	})
+]), d = e.Literals([
+	"provider",
+	"tool",
+	"timeout",
+	"cancelled",
+	"decode",
+	"internal"
+]), f = e.Struct({
+	inputTokens: e.optional(e.Number),
+	outputTokens: e.optional(e.Number),
+	totalTokens: e.optional(e.Number)
+}), p = e.Union([
+	e.Struct({
+		_tag: e.Literal("token"),
+		text: e.String
+	}),
+	e.Struct({
+		_tag: e.Literal("reasoning"),
+		text: e.String
+	}),
+	e.Struct({
+		_tag: e.Literal("toolCall"),
+		id: e.String,
+		name: e.String,
+		input: e.Unknown
+	}),
+	e.Struct({
+		_tag: e.Literal("toolResult"),
+		id: e.String,
+		name: e.String,
+		output: e.optional(e.Unknown),
+		error: e.optional(e.String)
+	}),
+	e.Struct({
+		_tag: e.Literal("source"),
+		sourceType: e.Literals(["url", "document"]),
+		id: e.String,
+		url: e.optional(e.String),
+		title: e.optional(e.String),
+		mediaType: e.optional(e.String),
+		filename: e.optional(e.String),
+		providerMetadata: e.optional(e.Unknown)
+	}),
+	e.Struct({
+		_tag: e.Literal("file"),
+		mediaType: e.String,
+		data: e.String,
+		providerMetadata: e.optional(e.Unknown)
+	}),
+	e.Struct({
+		_tag: e.Literal("stepMetadata"),
+		step: e.Int.pipe(e.check(e.isGreaterThanOrEqualTo(0))),
+		providerMetadata: e.Unknown
+	}),
+	e.Struct({
+		_tag: e.Literal("message"),
+		role: e.String,
+		content: e.String
+	}),
+	e.Struct({
+		_tag: e.Literal("error"),
+		code: d,
+		message: e.String,
+		retryable: e.Boolean
+	}),
+	e.Struct({
+		_tag: e.Literal("done"),
+		finishReason: e.String,
+		usage: f
+	})
+]), m = e.Struct({
+	seq: e.Number,
+	event: p
+});
+//#endregion
+export { u as a, s as i, p as n, t as o, m as r, i as s, d as t };