@yolk-sdk/agent 0.0.1-canary.0

package/dist/protocol/reasoning.d.mts

@@ -0,0 +1,8 @@
+import * as Schema from "effect/Schema";
+
+//#region src/protocol/reasoning.d.ts
+declare const AgentReasoningEffort: Schema.Literals<readonly ["minimal", "low", "medium", "high", "xhigh"]>;
+type AgentReasoningEffort = typeof AgentReasoningEffort.Type;
+//#endregion
+export { AgentReasoningEffort };
+//# sourceMappingURL=reasoning.d.mts.map

package/dist/protocol/reasoning.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning.d.mts","names":[],"sources":["../../src/protocol/reasoning.ts"],"mappings":";;;cAEa,oBAAA,EAAoB,MAAA,CAAA,QAAA;AAAA,KACrB,oBAAA,UAA8B,oBAAA,CAAqB,IAAI"}

package/dist/protocol/reasoning.mjs

@@ -0,0 +1,13 @@
+import * as Schema from "effect/Schema";
+//#region src/protocol/reasoning.ts
+const AgentReasoningEffort = Schema.Literals([
+	"minimal",
+	"low",
+	"medium",
+	"high",
+	"xhigh"
+]);
+//#endregion
+export { AgentReasoningEffort };
+
+//# sourceMappingURL=reasoning.mjs.map

package/dist/protocol/reasoning.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning.mjs","names":[],"sources":["../../src/protocol/reasoning.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\n\nexport const AgentReasoningEffort = Schema.Literals(['minimal', 'low', 'medium', 'high', 'xhigh'])\nexport type AgentReasoningEffort = typeof AgentReasoningEffort.Type\n"],"mappings":";;AAEA,MAAa,uBAAuB,OAAO,SAAS;CAAC;CAAW;CAAO;CAAU;CAAQ;AAAO,CAAC"}

package/dist/protocol/session.d.mts

@@ -0,0 +1,39 @@
+import { QuestionResponse, ToolApprovalResponse } from "./tool.mjs";
+import { AssistantAgentMessage, ToolResultMessage, UserMessage } from "./message.mjs";
+import { AgentAwaitingInput, AgentEnd, AgentError, AgentRetry, AgentStart, AssistantMessageEvent, CompactionEnd, CompactionStart, LLMReasoningDelta, LLMStreamEnd, LLMStreamStart, LLMTextDelta, ProviderToolResult, QuestionAnswered, QuestionCancelled, QuestionRequested, SubagentCompleted, SubagentStarted, ToolApprovalDenied, ToolApprovalGranted, ToolApprovalRequested, ToolExecutionCompleted, ToolExecutionError, ToolExecutionStarted, ToolInputDelta, ToolInputEnd, ToolInputStart, TurnEnd, TurnStart, UsageUpdate } from "./event.mjs";
+import * as Schema from "effect/Schema";
+
+//#region src/protocol/session.d.ts
+declare const SessionSnapshot_base: Schema.Class<SessionSnapshot, Schema.TaggedStruct<"SessionSnapshot", {
+  readonly revision: Schema.Number;
+  readonly messages: Schema.$Array<Schema.Union<readonly [typeof UserMessage, typeof AssistantAgentMessage, typeof ToolResultMessage]>>;
+}>, {}>;
+declare class SessionSnapshot extends SessionSnapshot_base {}
+declare const UserInput_base: Schema.Class<UserInput, Schema.TaggedStruct<"UserInput", {
+  readonly message: typeof UserMessage;
+  readonly expectedRevision: Schema.optional<Schema.Number>;
+  readonly model: Schema.optional<Schema.String>;
+  readonly reasoningEffort: Schema.optional<Schema.Literals<readonly ["minimal", "low", "medium", "high", "xhigh"]>>;
+}>, {}>;
+declare class UserInput extends UserInput_base {}
+declare const ToolApprovalResponseInput_base: Schema.Class<ToolApprovalResponseInput, Schema.TaggedStruct<"ToolApprovalResponseInput", {
+  readonly response: typeof ToolApprovalResponse;
+  readonly expectedRevision: Schema.optional<Schema.Number>;
+  readonly model: Schema.optional<Schema.String>;
+  readonly reasoningEffort: Schema.optional<Schema.Literals<readonly ["minimal", "low", "medium", "high", "xhigh"]>>;
+}>, {}>;
+declare class ToolApprovalResponseInput extends ToolApprovalResponseInput_base {}
+declare const QuestionResponseInput_base: Schema.Class<QuestionResponseInput, Schema.TaggedStruct<"QuestionResponseInput", {
+  readonly response: typeof QuestionResponse;
+  readonly expectedRevision: Schema.optional<Schema.Number>;
+  readonly model: Schema.optional<Schema.String>;
+  readonly reasoningEffort: Schema.optional<Schema.Literals<readonly ["minimal", "low", "medium", "high", "xhigh"]>>;
+}>, {}>;
+declare class QuestionResponseInput extends QuestionResponseInput_base {}
+declare const AgentWebSocketClientMessage: Schema.Union<readonly [typeof UserInput, typeof ToolApprovalResponseInput, typeof QuestionResponseInput]>;
+type AgentWebSocketClientMessage = typeof AgentWebSocketClientMessage.Type;
+declare const AgentWebSocketServerMessage: Schema.Union<readonly [typeof SessionSnapshot, Schema.Union<readonly [typeof AgentStart, typeof AgentError, typeof AgentEnd, typeof AgentAwaitingInput, typeof UsageUpdate, typeof AgentRetry, typeof CompactionStart, typeof CompactionEnd, typeof TurnStart, typeof TurnEnd, typeof LLMStreamStart, typeof LLMTextDelta, typeof LLMReasoningDelta, typeof ToolInputStart, typeof ToolInputDelta, typeof ToolInputEnd, typeof LLMStreamEnd, typeof AssistantMessageEvent, typeof ToolApprovalRequested, typeof ToolApprovalGranted, typeof ToolApprovalDenied, typeof QuestionRequested, typeof QuestionAnswered, typeof QuestionCancelled, typeof ToolExecutionStarted, typeof ToolExecutionCompleted, typeof ToolExecutionError, typeof ProviderToolResult, typeof SubagentStarted, typeof SubagentCompleted]>]>;
+type AgentWebSocketServerMessage = typeof AgentWebSocketServerMessage.Type;
+//#endregion
+export { AgentWebSocketClientMessage, AgentWebSocketServerMessage, QuestionResponseInput, SessionSnapshot, ToolApprovalResponseInput, UserInput };
+//# sourceMappingURL=session.d.mts.map

package/dist/protocol/session.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.mts","names":[],"sources":["../../src/protocol/session.ts"],"mappings":";;;;;;cAIkE,oBAAA;;;;cAErD,eAAA,SAAwB,oBAGnC;AAAA,cAAG,cAAA;;;;;;cAEQ,SAAA,SAAkB,cAK7B;AAAA,cAAG,8BAAA;;;;;;cAEQ,yBAAA,SAAkC,8BAQ9C;AAAA,cAAG,0BAAA;;;;;;cAES,qBAAA,SAA8B,0BAQ1C;AAAA,cAEY,2BAAA,EAA2B,MAAA,CAAA,KAAA,kBAAA,SAAA,SAAA,yBAAA,SAAA,qBAAA;AAAA,KAK5B,2BAAA,UAAqC,2BAAA,CAA4B,IAAI;AAAA,cAEpE,2BAAA,EAA2B,MAAA,CAAA,KAAA,kBAAA,eAAA,EAAA,MAAA,CAAA,KAAA,kBAAA,UAAA,SAAA,UAAA,SAAA,QAAA,SAAA,kBAAA,SAAA,WAAA,SAAA,UAAA,SAAA,eAAA,SAAA,aAAA,SAAA,SAAA,SAAA,OAAA,SAAA,cAAA,SAAA,YAAA,SAAA,iBAAA,SAAA,cAAA,SAAA,cAAA,SAAA,YAAA,SAAA,YAAA,SAAA,qBAAA,SAAA,qBAAA,SAAA,mBAAA,SAAA,kBAAA,SAAA,iBAAA,SAAA,gBAAA,SAAA,iBAAA,SAAA,oBAAA,SAAA,sBAAA,SAAA,kBAAA,SAAA,kBAAA,SAAA,eAAA,SAAA,iBAAA;AAAA,KAC5B,2BAAA,UAAqC,2BAAA,CAA4B,IAAI"}

package/dist/protocol/session.mjs

@@ -0,0 +1,38 @@
+import { QuestionResponse, ToolApprovalResponse } from "./tool.mjs";
+import { AgentMessage, UserMessage } from "./message.mjs";
+import { AgentEvent } from "./event.mjs";
+import { AgentReasoningEffort } from "./reasoning.mjs";
+import * as Schema from "effect/Schema";
+//#region src/protocol/session.ts
+var SessionSnapshot = class extends Schema.TaggedClass()("SessionSnapshot", {
+	revision: Schema.Number,
+	messages: Schema.Array(AgentMessage)
+}) {};
+var UserInput = class extends Schema.TaggedClass()("UserInput", {
+	message: UserMessage,
+	expectedRevision: Schema.optional(Schema.Number),
+	model: Schema.optional(Schema.String),
+	reasoningEffort: Schema.optional(AgentReasoningEffort)
+}) {};
+var ToolApprovalResponseInput = class extends Schema.TaggedClass()("ToolApprovalResponseInput", {
+	response: ToolApprovalResponse,
+	expectedRevision: Schema.optional(Schema.Number),
+	model: Schema.optional(Schema.String),
+	reasoningEffort: Schema.optional(AgentReasoningEffort)
+}) {};
+var QuestionResponseInput = class extends Schema.TaggedClass()("QuestionResponseInput", {
+	response: QuestionResponse,
+	expectedRevision: Schema.optional(Schema.Number),
+	model: Schema.optional(Schema.String),
+	reasoningEffort: Schema.optional(AgentReasoningEffort)
+}) {};
+const AgentWebSocketClientMessage = Schema.Union([
+	UserInput,
+	ToolApprovalResponseInput,
+	QuestionResponseInput
+]);
+const AgentWebSocketServerMessage = Schema.Union([SessionSnapshot, AgentEvent]);
+//#endregion
+export { AgentWebSocketClientMessage, AgentWebSocketServerMessage, QuestionResponseInput, SessionSnapshot, ToolApprovalResponseInput, UserInput };
+
+//# sourceMappingURL=session.mjs.map

package/dist/protocol/session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.mjs","names":[],"sources":["../../src/protocol/session.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\nimport { AgentEvent } from './event.ts'\nimport { AgentMessage, UserMessage } from './message.ts'\nimport { AgentReasoningEffort } from './reasoning.ts'\nimport { QuestionResponse, ToolApprovalResponse } from './tool.ts'\n\nexport class SessionSnapshot extends Schema.TaggedClass<SessionSnapshot>()('SessionSnapshot', {\n  revision: Schema.Number,\n  messages: Schema.Array(AgentMessage)\n}) {}\n\nexport class UserInput extends Schema.TaggedClass<UserInput>()('UserInput', {\n  message: UserMessage,\n  expectedRevision: Schema.optional(Schema.Number),\n  model: Schema.optional(Schema.String),\n  reasoningEffort: Schema.optional(AgentReasoningEffort)\n}) {}\n\nexport class ToolApprovalResponseInput extends Schema.TaggedClass<ToolApprovalResponseInput>()(\n  'ToolApprovalResponseInput',\n  {\n    response: ToolApprovalResponse,\n    expectedRevision: Schema.optional(Schema.Number),\n    model: Schema.optional(Schema.String),\n    reasoningEffort: Schema.optional(AgentReasoningEffort)\n  }\n) {}\n\nexport class QuestionResponseInput extends Schema.TaggedClass<QuestionResponseInput>()(\n  'QuestionResponseInput',\n  {\n    response: QuestionResponse,\n    expectedRevision: Schema.optional(Schema.Number),\n    model: Schema.optional(Schema.String),\n    reasoningEffort: Schema.optional(AgentReasoningEffort)\n  }\n) {}\n\nexport const AgentWebSocketClientMessage = Schema.Union([\n  UserInput,\n  ToolApprovalResponseInput,\n  QuestionResponseInput\n])\nexport type AgentWebSocketClientMessage = typeof AgentWebSocketClientMessage.Type\n\nexport const AgentWebSocketServerMessage = Schema.Union([SessionSnapshot, AgentEvent])\nexport type AgentWebSocketServerMessage = typeof AgentWebSocketServerMessage.Type\n"],"mappings":";;;;;;AAMA,IAAa,kBAAb,cAAqC,OAAO,YAA6B,EAAE,mBAAmB;CAC5F,UAAU,OAAO;CACjB,UAAU,OAAO,MAAM,YAAY;AACrC,CAAC,EAAE,CAAC;AAEJ,IAAa,YAAb,cAA+B,OAAO,YAAuB,EAAE,aAAa;CAC1E,SAAS;CACT,kBAAkB,OAAO,SAAS,OAAO,MAAM;CAC/C,OAAO,OAAO,SAAS,OAAO,MAAM;CACpC,iBAAiB,OAAO,SAAS,oBAAoB;AACvD,CAAC,EAAE,CAAC;AAEJ,IAAa,4BAAb,cAA+C,OAAO,YAAuC,EAC3F,6BACA;CACE,UAAU;CACV,kBAAkB,OAAO,SAAS,OAAO,MAAM;CAC/C,OAAO,OAAO,SAAS,OAAO,MAAM;CACpC,iBAAiB,OAAO,SAAS,oBAAoB;AACvD,CACF,EAAE,CAAC;AAEH,IAAa,wBAAb,cAA2C,OAAO,YAAmC,EACnF,yBACA;CACE,UAAU;CACV,kBAAkB,OAAO,SAAS,OAAO,MAAM;CAC/C,OAAO,OAAO,SAAS,OAAO,MAAM;CACpC,iBAAiB,OAAO,SAAS,oBAAoB;AACvD,CACF,EAAE,CAAC;AAEH,MAAa,8BAA8B,OAAO,MAAM;CACtD;CACA;CACA;AACF,CAAC;AAGD,MAAa,8BAA8B,OAAO,MAAM,CAAC,iBAAiB,UAAU,CAAC"}

package/dist/protocol/tool.d.mts

@@ -0,0 +1,101 @@
+import { AudioPart, ImagePart, TextPart } from "./content.mjs";
+import * as Schema from "effect/Schema";
+
+//#region src/protocol/tool.d.ts
+declare const HitlResponseSource: Schema.Literals<readonly ["user", "policy", "replay"]>;
+type HitlResponseSource = typeof HitlResponseSource.Type;
+declare const ToolApprovalDecision: Schema.Literals<readonly ["approved", "denied"]>;
+type ToolApprovalDecision = typeof ToolApprovalDecision.Type;
+declare const ToolApprovalMode: Schema.Literals<readonly ["manual"]>;
+type ToolApprovalMode = typeof ToolApprovalMode.Type;
+declare const ToolApprovalPolicy_base: Schema.Class<ToolApprovalPolicy, Schema.Struct<{
+  readonly mode: Schema.Literals<readonly ["manual"]>;
+  readonly reason: Schema.optional<Schema.String>;
+}>, {}>;
+declare class ToolApprovalPolicy extends ToolApprovalPolicy_base {}
+declare const ToolCall_base: Schema.Class<ToolCall, Schema.Struct<{
+  readonly id: Schema.Trimmed;
+  readonly name: Schema.Trimmed;
+  readonly params: Schema.Unknown;
+}>, {}>;
+declare class ToolCall extends ToolCall_base {}
+declare const ToolDef_base: Schema.Class<ToolDef, Schema.Struct<{
+  readonly name: Schema.Trimmed;
+  readonly description: Schema.String;
+  readonly parameters: Schema.Unknown;
+  readonly approval: Schema.optional<typeof ToolApprovalPolicy>;
+}>, {}>;
+declare class ToolDef extends ToolDef_base {}
+declare const ToolResult_base: Schema.Class<ToolResult, Schema.Struct<{
+  readonly toolCallId: Schema.Trimmed;
+  readonly content: Schema.Union<readonly [Schema.String, Schema.$Array<Schema.Union<readonly [typeof TextPart, typeof ImagePart, typeof AudioPart]>>]>;
+  readonly isError: Schema.optional<Schema.Boolean>;
+  readonly structuredContent: Schema.optional<Schema.Unknown>;
+}>, {}>;
+declare class ToolResult extends ToolResult_base {}
+declare const ToolApprovalRequest_base: Schema.Class<ToolApprovalRequest, Schema.TaggedStruct<"ToolApprovalRequest", {
+  readonly requestId: Schema.Trimmed;
+  readonly toolCallId: Schema.Trimmed;
+  readonly call: typeof ToolCall;
+  readonly policy: Schema.optional<typeof ToolApprovalPolicy>;
+}>, {}>;
+declare class ToolApprovalRequest extends ToolApprovalRequest_base {}
+declare const ToolApprovalResponse_base: Schema.Class<ToolApprovalResponse, Schema.TaggedStruct<"ToolApprovalResponse", {
+  readonly requestId: Schema.Trimmed;
+  readonly toolCallId: Schema.Trimmed;
+  readonly decision: Schema.Literals<readonly ["approved", "denied"]>;
+  readonly source: Schema.Literals<readonly ["user", "policy", "replay"]>;
+  readonly reason: Schema.optional<Schema.String>;
+}>, {}>;
+declare class ToolApprovalResponse extends ToolApprovalResponse_base {}
+declare const QuestionOption_base: Schema.Class<QuestionOption, Schema.Struct<{
+  readonly id: Schema.Trimmed;
+  readonly label: Schema.Trimmed;
+  readonly description: Schema.optional<Schema.String>;
+}>, {}>;
+declare class QuestionOption extends QuestionOption_base {}
+declare const QuestionPrompt_base: Schema.Class<QuestionPrompt, Schema.Struct<{
+  readonly id: Schema.Trimmed;
+  readonly prompt: Schema.Trimmed;
+  readonly options: Schema.optional<Schema.$Array<typeof QuestionOption>>;
+  readonly multiple: Schema.optional<Schema.Boolean>;
+  readonly allowCustom: Schema.optional<Schema.Boolean>;
+  readonly required: Schema.optional<Schema.Boolean>;
+}>, {}>;
+declare class QuestionPrompt extends QuestionPrompt_base {}
+declare const QuestionToolParams_base: Schema.Class<QuestionToolParams, Schema.Struct<{
+  readonly questions: Schema.NonEmptyArray<typeof QuestionPrompt>;
+}>, {}>;
+declare class QuestionToolParams extends QuestionToolParams_base {}
+declare const QuestionRequest_base: Schema.Class<QuestionRequest, Schema.TaggedStruct<"QuestionRequest", {
+  readonly requestId: Schema.Trimmed;
+  readonly toolCallId: Schema.Trimmed;
+  readonly call: typeof ToolCall;
+  readonly questions: Schema.NonEmptyArray<typeof QuestionPrompt>;
+}>, {}>;
+declare class QuestionRequest extends QuestionRequest_base {}
+declare const QuestionAnswer_base: Schema.Class<QuestionAnswer, Schema.Struct<{
+  readonly questionId: Schema.Trimmed;
+  readonly optionIds: Schema.optional<Schema.$Array<Schema.Trimmed>>;
+  readonly customAnswer: Schema.optional<Schema.String>;
+}>, {}>;
+declare class QuestionAnswer extends QuestionAnswer_base {}
+declare const QuestionResponseOutcome: Schema.Literals<readonly ["answered", "cancelled"]>;
+type QuestionResponseOutcome = typeof QuestionResponseOutcome.Type;
+declare const QuestionResponse_base: Schema.Class<QuestionResponse, Schema.TaggedStruct<"QuestionResponse", {
+  readonly requestId: Schema.Trimmed;
+  readonly toolCallId: Schema.Trimmed;
+  readonly outcome: Schema.Literals<readonly ["answered", "cancelled"]>;
+  readonly source: Schema.Literals<readonly ["user", "policy", "replay"]>;
+  readonly answers: Schema.optional<Schema.$Array<typeof QuestionAnswer>>;
+  readonly reason: Schema.optional<Schema.String>;
+}>, {}>;
+declare class QuestionResponse extends QuestionResponse_base {}
+declare const formatQuestionResponseContent: (response: QuestionResponse, questions?: ReadonlyArray<QuestionPrompt>) => string;
+declare const HitlRequest: Schema.Union<readonly [typeof ToolApprovalRequest, typeof QuestionRequest]>;
+type HitlRequest = typeof HitlRequest.Type;
+declare const HitlResponse: Schema.Union<readonly [typeof ToolApprovalResponse, typeof QuestionResponse]>;
+type HitlResponse = typeof HitlResponse.Type;
+//#endregion
+export { HitlRequest, HitlResponse, HitlResponseSource, QuestionAnswer, QuestionOption, QuestionPrompt, QuestionRequest, QuestionResponse, QuestionResponseOutcome, QuestionToolParams, ToolApprovalDecision, ToolApprovalMode, ToolApprovalPolicy, ToolApprovalRequest, ToolApprovalResponse, ToolCall, ToolDef, ToolResult, formatQuestionResponseContent };
+//# sourceMappingURL=tool.d.mts.map

package/dist/protocol/tool.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.mts","names":[],"sources":["../../src/protocol/tool.ts"],"mappings":";;;;cAKa,kBAAA,EAAkB,MAAA,CAAA,QAAA;AAAA,KACnB,kBAAA,UAA4B,kBAAA,CAAmB,IAAI;AAAA,cAElD,oBAAA,EAAoB,MAAA,CAAA,QAAA;AAAA,KACrB,oBAAA,UAA8B,oBAAA,CAAqB,IAAI;AAAA,cAEtD,gBAAA,EAAgB,MAAA,CAAA,QAAA;AAAA,KACjB,gBAAA,UAA0B,gBAAA,CAAiB,IAAI;AAAA,cAAA,uBAAA;;;;cAE9C,kBAAA,SAA2B,uBAGtC;AAAA,cAAG,aAAA;;;;;cAEQ,QAAA,SAAiB,aAI5B;AAAA,cAAG,YAAA;;;;;;cAEQ,OAAA,SAAgB,YAK3B;AAAA,cAAG,eAAA;;;;;;cAEQ,UAAA,SAAmB,eAK9B;AAAA,cAAG,wBAAA;;;;;;cAEQ,mBAAA,SAA4B,wBAQxC;AAAA,cAAG,yBAAA;;;;;;;cAES,oBAAA,SAA6B,yBASzC;AAAA,cAAG,mBAAA;;;;;cAES,cAAA,SAAuB,mBAIlC;AAAA,cAAG,mBAAA;;;;;;;;cAEQ,cAAA,SAAuB,mBAOlC;AAAA,cAAG,uBAAA;;;cAEQ,kBAAA,SAA2B,uBAEtC;AAAA,cAAG,oBAAA;;;;;;cAEQ,eAAA,SAAwB,oBAKnC;AAAA,cAAG,mBAAA;;;;;cAEQ,cAAA,SAAuB,mBAIlC;AAAA,cAEW,uBAAA,EAAuB,MAAA,CAAA,QAAA;AAAA,KACxB,uBAAA,UAAiC,uBAAA,CAAwB,IAAI;AAAA,cAAA,qBAAA;;;;;;;;cAE5D,gBAAA,SAAyB,qBAOpC;AAAA,cAyBW,6BAAA,GACX,QAAA,EAAU,gBAAA,EACV,SAAA,GAAW,aAAA,CAAc,cAAA;AAAA,cAoBd,WAAA,EAAW,MAAA,CAAA,KAAA,kBAAA,mBAAA,SAAA,eAAA;AAAA,KACZ,WAAA,UAAqB,WAAA,CAAY,IAAI;AAAA,cAEpC,YAAA,EAAY,MAAA,CAAA,KAAA,kBAAA,oBAAA,SAAA,gBAAA;AAAA,KACb,YAAA,UAAsB,YAAA,CAAa,IAAI"}

package/dist/protocol/tool.mjs

@@ -0,0 +1,102 @@
+import { Content } from "./content.mjs";
+import * as Schema from "effect/Schema";
+//#region src/protocol/tool.ts
+const NonEmptyTrimmedString = Schema.Trimmed.pipe(Schema.check(Schema.isNonEmpty()));
+const HitlResponseSource = Schema.Literals([
+	"user",
+	"policy",
+	"replay"
+]);
+const ToolApprovalDecision = Schema.Literals(["approved", "denied"]);
+const ToolApprovalMode = Schema.Literals(["manual"]);
+var ToolApprovalPolicy = class extends Schema.Class("ToolApprovalPolicy")({
+	mode: ToolApprovalMode,
+	reason: Schema.optional(Schema.String)
+}) {};
+var ToolCall = class extends Schema.Class("ToolCall")({
+	id: NonEmptyTrimmedString,
+	name: NonEmptyTrimmedString,
+	params: Schema.Unknown
+}) {};
+var ToolDef = class extends Schema.Class("ToolDef")({
+	name: NonEmptyTrimmedString,
+	description: Schema.String,
+	parameters: Schema.Unknown,
+	approval: Schema.optional(ToolApprovalPolicy)
+}) {};
+var ToolResult = class extends Schema.Class("ToolResult")({
+	toolCallId: NonEmptyTrimmedString,
+	content: Content,
+	isError: Schema.optional(Schema.Boolean),
+	structuredContent: Schema.optional(Schema.Unknown)
+}) {};
+var ToolApprovalRequest = class extends Schema.TaggedClass()("ToolApprovalRequest", {
+	requestId: NonEmptyTrimmedString,
+	toolCallId: NonEmptyTrimmedString,
+	call: ToolCall,
+	policy: Schema.optional(ToolApprovalPolicy)
+}) {};
+var ToolApprovalResponse = class extends Schema.TaggedClass()("ToolApprovalResponse", {
+	requestId: NonEmptyTrimmedString,
+	toolCallId: NonEmptyTrimmedString,
+	decision: ToolApprovalDecision,
+	source: HitlResponseSource,
+	reason: Schema.optional(Schema.String)
+}) {};
+var QuestionOption = class extends Schema.Class("QuestionOption")({
+	id: NonEmptyTrimmedString,
+	label: NonEmptyTrimmedString,
+	description: Schema.optional(Schema.String)
+}) {};
+var QuestionPrompt = class extends Schema.Class("QuestionPrompt")({
+	id: NonEmptyTrimmedString,
+	prompt: NonEmptyTrimmedString,
+	options: Schema.optional(Schema.Array(QuestionOption)),
+	multiple: Schema.optional(Schema.Boolean),
+	allowCustom: Schema.optional(Schema.Boolean),
+	required: Schema.optional(Schema.Boolean)
+}) {};
+var QuestionToolParams = class extends Schema.Class("QuestionToolParams")({ questions: Schema.NonEmptyArray(QuestionPrompt) }) {};
+var QuestionRequest = class extends Schema.TaggedClass()("QuestionRequest", {
+	requestId: NonEmptyTrimmedString,
+	toolCallId: NonEmptyTrimmedString,
+	call: ToolCall,
+	questions: Schema.NonEmptyArray(QuestionPrompt)
+}) {};
+var QuestionAnswer = class extends Schema.Class("QuestionAnswer")({
+	questionId: NonEmptyTrimmedString,
+	optionIds: Schema.optional(Schema.Array(NonEmptyTrimmedString)),
+	customAnswer: Schema.optional(Schema.String)
+}) {};
+const QuestionResponseOutcome = Schema.Literals(["answered", "cancelled"]);
+var QuestionResponse = class extends Schema.TaggedClass()("QuestionResponse", {
+	requestId: NonEmptyTrimmedString,
+	toolCallId: NonEmptyTrimmedString,
+	outcome: QuestionResponseOutcome,
+	source: HitlResponseSource,
+	answers: Schema.optional(Schema.Array(QuestionAnswer)),
+	reason: Schema.optional(Schema.String)
+}) {};
+const optionLabel = (question, optionId) => question.options?.find((option) => option.id === optionId)?.label ?? optionId;
+const questionForAnswer = (questions, answer) => questions.find((question) => question.id === answer.questionId);
+const formatQuestionAnswer = (answer, questions) => {
+	const question = questionForAnswer(questions, answer);
+	const prompt = question?.prompt ?? answer.questionId;
+	const selected = answer.optionIds?.map((optionId) => question === void 0 ? optionId : optionLabel(question, optionId)) ?? [];
+	const custom = answer.customAnswer?.trim();
+	const values = custom === void 0 || custom.length === 0 ? selected : [...selected, custom];
+	return values.length === 0 ? `- ${prompt}: answered` : `- ${prompt}: ${values.join(", ")}`;
+};
+const formatQuestionResponseContent = (response, questions = []) => {
+	if (response.outcome === "cancelled") return `Question cancelled: ${response.reason ?? "Question cancelled"}`;
+	const answers = response.answers ?? [];
+	if (answers.length === 0) return "User answered the question, but no answer values were provided. Continue with this in mind.";
+	const formatted = answers.map((answer) => formatQuestionAnswer(answer, questions).slice(2)).join("; ");
+	return `User has answered your ${answers.length === 1 ? "question" : "questions"}: ${formatted}. Continue with the user's answers in mind.`;
+};
+const HitlRequest = Schema.Union([ToolApprovalRequest, QuestionRequest]);
+const HitlResponse = Schema.Union([ToolApprovalResponse, QuestionResponse]);
+//#endregion
+export { HitlRequest, HitlResponse, HitlResponseSource, QuestionAnswer, QuestionOption, QuestionPrompt, QuestionRequest, QuestionResponse, QuestionResponseOutcome, QuestionToolParams, ToolApprovalDecision, ToolApprovalMode, ToolApprovalPolicy, ToolApprovalRequest, ToolApprovalResponse, ToolCall, ToolDef, ToolResult, formatQuestionResponseContent };
+
+//# sourceMappingURL=tool.mjs.map

package/dist/protocol/tool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.mjs","names":[],"sources":["../../src/protocol/tool.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\nimport { Content } from './content.ts'\n\nconst NonEmptyTrimmedString = Schema.Trimmed.pipe(Schema.check(Schema.isNonEmpty()))\n\nexport const HitlResponseSource = Schema.Literals(['user', 'policy', 'replay'])\nexport type HitlResponseSource = typeof HitlResponseSource.Type\n\nexport const ToolApprovalDecision = Schema.Literals(['approved', 'denied'])\nexport type ToolApprovalDecision = typeof ToolApprovalDecision.Type\n\nexport const ToolApprovalMode = Schema.Literals(['manual'])\nexport type ToolApprovalMode = typeof ToolApprovalMode.Type\n\nexport class ToolApprovalPolicy extends Schema.Class<ToolApprovalPolicy>('ToolApprovalPolicy')({\n  mode: ToolApprovalMode,\n  reason: Schema.optional(Schema.String)\n}) {}\n\nexport class ToolCall extends Schema.Class<ToolCall>('ToolCall')({\n  id: NonEmptyTrimmedString,\n  name: NonEmptyTrimmedString,\n  params: Schema.Unknown\n}) {}\n\nexport class ToolDef extends Schema.Class<ToolDef>('ToolDef')({\n  name: NonEmptyTrimmedString,\n  description: Schema.String,\n  parameters: Schema.Unknown,\n  approval: Schema.optional(ToolApprovalPolicy)\n}) {}\n\nexport class ToolResult extends Schema.Class<ToolResult>('ToolResult')({\n  toolCallId: NonEmptyTrimmedString,\n  content: Content,\n  isError: Schema.optional(Schema.Boolean),\n  structuredContent: Schema.optional(Schema.Unknown)\n}) {}\n\nexport class ToolApprovalRequest extends Schema.TaggedClass<ToolApprovalRequest>()(\n  'ToolApprovalRequest',\n  {\n    requestId: NonEmptyTrimmedString,\n    toolCallId: NonEmptyTrimmedString,\n    call: ToolCall,\n    policy: Schema.optional(ToolApprovalPolicy)\n  }\n) {}\n\nexport class ToolApprovalResponse extends Schema.TaggedClass<ToolApprovalResponse>()(\n  'ToolApprovalResponse',\n  {\n    requestId: NonEmptyTrimmedString,\n    toolCallId: NonEmptyTrimmedString,\n    decision: ToolApprovalDecision,\n    source: HitlResponseSource,\n    reason: Schema.optional(Schema.String)\n  }\n) {}\n\nexport class QuestionOption extends Schema.Class<QuestionOption>('QuestionOption')({\n  id: NonEmptyTrimmedString,\n  label: NonEmptyTrimmedString,\n  description: Schema.optional(Schema.String)\n}) {}\n\nexport class QuestionPrompt extends Schema.Class<QuestionPrompt>('QuestionPrompt')({\n  id: NonEmptyTrimmedString,\n  prompt: NonEmptyTrimmedString,\n  options: Schema.optional(Schema.Array(QuestionOption)),\n  multiple: Schema.optional(Schema.Boolean),\n  allowCustom: Schema.optional(Schema.Boolean),\n  required: Schema.optional(Schema.Boolean)\n}) {}\n\nexport class QuestionToolParams extends Schema.Class<QuestionToolParams>('QuestionToolParams')({\n  questions: Schema.NonEmptyArray(QuestionPrompt)\n}) {}\n\nexport class QuestionRequest extends Schema.TaggedClass<QuestionRequest>()('QuestionRequest', {\n  requestId: NonEmptyTrimmedString,\n  toolCallId: NonEmptyTrimmedString,\n  call: ToolCall,\n  questions: Schema.NonEmptyArray(QuestionPrompt)\n}) {}\n\nexport class QuestionAnswer extends Schema.Class<QuestionAnswer>('QuestionAnswer')({\n  questionId: NonEmptyTrimmedString,\n  optionIds: Schema.optional(Schema.Array(NonEmptyTrimmedString)),\n  customAnswer: Schema.optional(Schema.String)\n}) {}\n\nexport const QuestionResponseOutcome = Schema.Literals(['answered', 'cancelled'])\nexport type QuestionResponseOutcome = typeof QuestionResponseOutcome.Type\n\nexport class QuestionResponse extends Schema.TaggedClass<QuestionResponse>()('QuestionResponse', {\n  requestId: NonEmptyTrimmedString,\n  toolCallId: NonEmptyTrimmedString,\n  outcome: QuestionResponseOutcome,\n  source: HitlResponseSource,\n  answers: Schema.optional(Schema.Array(QuestionAnswer)),\n  reason: Schema.optional(Schema.String)\n}) {}\n\nconst optionLabel = (question: QuestionPrompt, optionId: string) =>\n  question.options?.find(option => option.id === optionId)?.label ?? optionId\n\nconst questionForAnswer = (\n  questions: ReadonlyArray<QuestionPrompt>,\n  answer: QuestionAnswer\n) => questions.find(question => question.id === answer.questionId)\n\nconst formatQuestionAnswer = (\n  answer: QuestionAnswer,\n  questions: ReadonlyArray<QuestionPrompt>\n) => {\n  const question = questionForAnswer(questions, answer)\n  const prompt = question?.prompt ?? answer.questionId\n  const selected = answer.optionIds?.map(optionId =>\n    question === undefined ? optionId : optionLabel(question, optionId)\n  ) ?? []\n  const custom = answer.customAnswer?.trim()\n  const values = custom === undefined || custom.length === 0 ? selected : [...selected, custom]\n\n  return values.length === 0 ? `- ${prompt}: answered` : `- ${prompt}: ${values.join(', ')}`\n}\n\nexport const formatQuestionResponseContent = (\n  response: QuestionResponse,\n  questions: ReadonlyArray<QuestionPrompt> = []\n) => {\n  if (response.outcome === 'cancelled') {\n    return `Question cancelled: ${response.reason ?? 'Question cancelled'}`\n  }\n\n  const answers = response.answers ?? []\n\n  if (answers.length === 0) {\n    return 'User answered the question, but no answer values were provided. Continue with this in mind.'\n  }\n\n  const formatted = answers\n    .map(answer => formatQuestionAnswer(answer, questions).slice('- '.length))\n    .join('; ')\n  const label = answers.length === 1 ? 'question' : 'questions'\n\n  return `User has answered your ${label}: ${formatted}. Continue with the user's answers in mind.`\n}\n\nexport const HitlRequest = Schema.Union([ToolApprovalRequest, QuestionRequest])\nexport type HitlRequest = typeof HitlRequest.Type\n\nexport const HitlResponse = Schema.Union([ToolApprovalResponse, QuestionResponse])\nexport type HitlResponse = typeof HitlResponse.Type\n"],"mappings":"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"}

package/dist/protocol/usage.d.mts

@@ -0,0 +1,26 @@
+import * as Schema from "effect/Schema";
+
+//#region src/protocol/usage.d.ts
+declare const AgentInputUsage_base: Schema.Class<AgentInputUsage, Schema.Struct<{
+  readonly total: Schema.Number;
+  readonly uncached: Schema.optional<Schema.Number>;
+  readonly cacheRead: Schema.optional<Schema.Number>;
+  readonly cacheWrite: Schema.optional<Schema.Number>;
+}>, {}>;
+declare class AgentInputUsage extends AgentInputUsage_base {}
+declare const AgentOutputUsage_base: Schema.Class<AgentOutputUsage, Schema.Struct<{
+  readonly total: Schema.Number;
+  readonly text: Schema.optional<Schema.Number>;
+  readonly reasoning: Schema.optional<Schema.Number>;
+}>, {}>;
+declare class AgentOutputUsage extends AgentOutputUsage_base {}
+declare const AgentUsage_base: Schema.Class<AgentUsage, Schema.Struct<{
+  readonly input: typeof AgentInputUsage;
+  readonly output: typeof AgentOutputUsage;
+}>, {}>;
+declare class AgentUsage extends AgentUsage_base {}
+declare const zeroAgentUsage: AgentUsage;
+declare const addAgentUsage: (left: AgentUsage, right: AgentUsage) => AgentUsage;
+//#endregion
+export { AgentInputUsage, AgentOutputUsage, AgentUsage, addAgentUsage, zeroAgentUsage };
+//# sourceMappingURL=usage.d.mts.map

package/dist/protocol/usage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.mts","names":[],"sources":["../../src/protocol/usage.ts"],"mappings":";;;cACuC,oBAAA;;;;;;cAE1B,eAAA,SAAwB,oBAKnC;AAAA,cAAG,qBAAA;;;;;cAEQ,gBAAA,SAAyB,qBAIpC;AAAA,cAAG,eAAA;;;;cAEQ,UAAA,SAAmB,eAG9B;AAAA,cAEW,cAAA,EAAc,UAGzB;AAAA,cAUW,aAAA,GAAiB,IAAA,EAAM,UAAA,EAAY,KAAA,EAAO,UAAA,KAAU,UAAA"}

package/dist/protocol/usage.mjs

@@ -0,0 +1,40 @@
+import { Array, Option } from "effect";
+import * as Schema from "effect/Schema";
+//#region src/protocol/usage.ts
+var AgentInputUsage = class extends Schema.Class("AgentInputUsage")({
+	total: Schema.Number,
+	uncached: Schema.optional(Schema.Number),
+	cacheRead: Schema.optional(Schema.Number),
+	cacheWrite: Schema.optional(Schema.Number)
+}) {};
+var AgentOutputUsage = class extends Schema.Class("AgentOutputUsage")({
+	total: Schema.Number,
+	text: Schema.optional(Schema.Number),
+	reasoning: Schema.optional(Schema.Number)
+}) {};
+var AgentUsage = class extends Schema.Class("AgentUsage")({
+	input: AgentInputUsage,
+	output: AgentOutputUsage
+}) {};
+const zeroAgentUsage = AgentUsage.make({
+	input: AgentInputUsage.make({ total: 0 }),
+	output: AgentOutputUsage.make({ total: 0 })
+});
+const sumOptional = (left, right) => Option.getOrUndefined(Option.liftPredicate(Array.getSomes([Option.fromNullishOr(left), Option.fromNullishOr(right)]), (values) => values.length > 0).pipe(Option.map((values) => Array.reduce(values, 0, (sum, value) => sum + value))));
+const addAgentUsage = (left, right) => AgentUsage.make({
+	input: AgentInputUsage.make({
+		total: left.input.total + right.input.total,
+		uncached: sumOptional(left.input.uncached, right.input.uncached),
+		cacheRead: sumOptional(left.input.cacheRead, right.input.cacheRead),
+		cacheWrite: sumOptional(left.input.cacheWrite, right.input.cacheWrite)
+	}),
+	output: AgentOutputUsage.make({
+		total: left.output.total + right.output.total,
+		text: sumOptional(left.output.text, right.output.text),
+		reasoning: sumOptional(left.output.reasoning, right.output.reasoning)
+	})
+});
+//#endregion
+export { AgentInputUsage, AgentOutputUsage, AgentUsage, addAgentUsage, zeroAgentUsage };
+
+//# sourceMappingURL=usage.mjs.map

package/dist/protocol/usage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.mjs","names":["Arr"],"sources":["../../src/protocol/usage.ts"],"sourcesContent":["import { Array as Arr, Option } from 'effect'\nimport * as Schema from 'effect/Schema'\n\nexport class AgentInputUsage extends Schema.Class<AgentInputUsage>('AgentInputUsage')({\n  total: Schema.Number,\n  uncached: Schema.optional(Schema.Number),\n  cacheRead: Schema.optional(Schema.Number),\n  cacheWrite: Schema.optional(Schema.Number)\n}) {}\n\nexport class AgentOutputUsage extends Schema.Class<AgentOutputUsage>('AgentOutputUsage')({\n  total: Schema.Number,\n  text: Schema.optional(Schema.Number),\n  reasoning: Schema.optional(Schema.Number)\n}) {}\n\nexport class AgentUsage extends Schema.Class<AgentUsage>('AgentUsage')({\n  input: AgentInputUsage,\n  output: AgentOutputUsage\n}) {}\n\nexport const zeroAgentUsage = AgentUsage.make({\n  input: AgentInputUsage.make({ total: 0 }),\n  output: AgentOutputUsage.make({ total: 0 })\n})\n\nconst sumOptional = (left: number | undefined, right: number | undefined) =>\n  Option.getOrUndefined(\n    Option.liftPredicate(\n      Arr.getSomes([Option.fromNullishOr(left), Option.fromNullishOr(right)]),\n      values => values.length > 0\n    ).pipe(Option.map(values => Arr.reduce(values, 0, (sum, value) => sum + value)))\n  )\n\nexport const addAgentUsage = (left: AgentUsage, right: AgentUsage) =>\n  AgentUsage.make({\n    input: AgentInputUsage.make({\n      total: left.input.total + right.input.total,\n      uncached: sumOptional(left.input.uncached, right.input.uncached),\n      cacheRead: sumOptional(left.input.cacheRead, right.input.cacheRead),\n      cacheWrite: sumOptional(left.input.cacheWrite, right.input.cacheWrite)\n    }),\n    output: AgentOutputUsage.make({\n      total: left.output.total + right.output.total,\n      text: sumOptional(left.output.text, right.output.text),\n      reasoning: sumOptional(left.output.reasoning, right.output.reasoning)\n    })\n  })\n"],"mappings":";;;AAGA,IAAa,kBAAb,cAAqC,OAAO,MAAuB,iBAAiB,EAAE;CACpF,OAAO,OAAO;CACd,UAAU,OAAO,SAAS,OAAO,MAAM;CACvC,WAAW,OAAO,SAAS,OAAO,MAAM;CACxC,YAAY,OAAO,SAAS,OAAO,MAAM;AAC3C,CAAC,EAAE,CAAC;AAEJ,IAAa,mBAAb,cAAsC,OAAO,MAAwB,kBAAkB,EAAE;CACvF,OAAO,OAAO;CACd,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,WAAW,OAAO,SAAS,OAAO,MAAM;AAC1C,CAAC,EAAE,CAAC;AAEJ,IAAa,aAAb,cAAgC,OAAO,MAAkB,YAAY,EAAE;CACrE,OAAO;CACP,QAAQ;AACV,CAAC,EAAE,CAAC;AAEJ,MAAa,iBAAiB,WAAW,KAAK;CAC5C,OAAO,gBAAgB,KAAK,EAAE,OAAO,EAAE,CAAC;CACxC,QAAQ,iBAAiB,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,eAAe,MAA0B,UAC7C,OAAO,eACL,OAAO,cACLA,MAAI,SAAS,CAAC,OAAO,cAAc,IAAI,GAAG,OAAO,cAAc,KAAK,CAAC,CAAC,IACtE,WAAU,OAAO,SAAS,CAC5B,EAAE,KAAK,OAAO,KAAI,WAAUA,MAAI,OAAO,QAAQ,IAAI,KAAK,UAAU,MAAM,KAAK,CAAC,CAAC,CACjF;AAEF,MAAa,iBAAiB,MAAkB,UAC9C,WAAW,KAAK;CACd,OAAO,gBAAgB,KAAK;EAC1B,OAAO,KAAK,MAAM,QAAQ,MAAM,MAAM;EACtC,UAAU,YAAY,KAAK,MAAM,UAAU,MAAM,MAAM,QAAQ;EAC/D,WAAW,YAAY,KAAK,MAAM,WAAW,MAAM,MAAM,SAAS;EAClE,YAAY,YAAY,KAAK,MAAM,YAAY,MAAM,MAAM,UAAU;CACvE,CAAC;CACD,QAAQ,iBAAiB,KAAK;EAC5B,OAAO,KAAK,OAAO,QAAQ,MAAM,OAAO;EACxC,MAAM,YAAY,KAAK,OAAO,MAAM,MAAM,OAAO,IAAI;EACrD,WAAW,YAAY,KAAK,OAAO,WAAW,MAAM,OAAO,SAAS;CACtE,CAAC;AACH,CAAC"}

package/dist/runtime/error.d.mts

@@ -0,0 +1,29 @@
+import * as Schema from "effect/Schema";
+import { AgentError } from "@yolk-sdk/agent/protocol";
+import { AgentLoopError } from "@yolk-sdk/agent/loop";
+
+//#region src/runtime/error.d.ts
+declare const SessionNotFoundError_base: Schema.Class<SessionNotFoundError, Schema.TaggedStruct<"SessionNotFoundError", {
+  readonly sessionId: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+declare class SessionNotFoundError extends SessionNotFoundError_base {}
+declare const SessionLoadError_base: Schema.Class<SessionLoadError, Schema.TaggedStruct<"SessionLoadError", {
+  readonly sessionId: Schema.String;
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+declare class SessionLoadError extends SessionLoadError_base {}
+declare const SessionSaveError_base: Schema.Class<SessionSaveError, Schema.TaggedStruct<"SessionSaveError", {
+  readonly sessionId: Schema.String;
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+declare class SessionSaveError extends SessionSaveError_base {}
+declare const SessionConflictError_base: Schema.Class<SessionConflictError, Schema.TaggedStruct<"SessionConflictError", {
+  readonly sessionId: Schema.String;
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+declare class SessionConflictError extends SessionConflictError_base {}
+type RuntimeError = SessionNotFoundError | SessionLoadError | SessionSaveError | SessionConflictError;
+declare const runtimeErrorToAgentError: (error: RuntimeError | AgentLoopError) => AgentError;
+//#endregion
+export { RuntimeError, SessionConflictError, SessionLoadError, SessionNotFoundError, SessionSaveError, runtimeErrorToAgentError };
+//# sourceMappingURL=error.d.mts.map

package/dist/runtime/error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.mts","names":[],"sources":["../../src/runtime/error.ts"],"mappings":";;;;;cAEqD,yBAAA;;;cAExC,oBAAA,SAA6B,yBAKzC;AAAA,cAAG,qBAAA;;;;cAES,gBAAA,SAAyB,qBAMrC;AAAA,cAAG,qBAAA;;;;cAES,gBAAA,SAAyB,qBAMrC;AAAA,cAAG,yBAAA;;;;cAES,oBAAA,SAA6B,yBAMzC;AAAA,KAEW,YAAA,GACR,oBAAA,GACA,gBAAA,GACA,gBAAA,GACA,oBAAA;AAAA,cAES,wBAAA,GAA4B,KAAA,EAAO,YAAA,GAAe,cAAA,KAAiB,UAAA"}

package/dist/runtime/error.mjs

@@ -0,0 +1,46 @@
+import * as Schema from "effect/Schema";
+import { AgentError } from "@yolk-sdk/agent/protocol";
+import { agentLoopErrorToAgentError } from "@yolk-sdk/agent/loop";
+//#region src/runtime/error.ts
+var SessionNotFoundError = class extends Schema.TaggedErrorClass()("SessionNotFoundError", { sessionId: Schema.String }) {};
+var SessionLoadError = class extends Schema.TaggedErrorClass()("SessionLoadError", {
+	sessionId: Schema.String,
+	message: Schema.String
+}) {};
+var SessionSaveError = class extends Schema.TaggedErrorClass()("SessionSaveError", {
+	sessionId: Schema.String,
+	message: Schema.String
+}) {};
+var SessionConflictError = class extends Schema.TaggedErrorClass()("SessionConflictError", {
+	sessionId: Schema.String,
+	message: Schema.String
+}) {};
+const runtimeErrorToAgentError = (error) => {
+	switch (error._tag) {
+		case "SessionNotFoundError": return AgentError.make({
+			code: "session_not_found",
+			message: `Session not found: ${error.sessionId}`,
+			retryable: false
+		});
+		case "SessionLoadError":
+		case "SessionSaveError": return AgentError.make({
+			code: "store_error",
+			message: error.message,
+			retryable: true
+		});
+		case "SessionConflictError": return AgentError.make({
+			code: "conflict",
+			message: error.message,
+			retryable: false
+		});
+		case "LLMError":
+		case "ToolError":
+		case "ContextTransformError":
+		case "AbortError":
+		case "FauxExhaustedError": return agentLoopErrorToAgentError(error);
+	}
+};
+//#endregion
+export { SessionConflictError, SessionLoadError, SessionNotFoundError, SessionSaveError, runtimeErrorToAgentError };
+
+//# sourceMappingURL=error.mjs.map

package/dist/runtime/error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.mjs","names":[],"sources":["../../src/runtime/error.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\nimport { agentLoopErrorToAgentError, type AgentLoopError } from '@yolk-sdk/agent/loop'\nimport { AgentError } from '@yolk-sdk/agent/protocol'\n\nexport class SessionNotFoundError extends Schema.TaggedErrorClass<SessionNotFoundError>()(\n  'SessionNotFoundError',\n  {\n    sessionId: Schema.String\n  }\n) {}\n\nexport class SessionLoadError extends Schema.TaggedErrorClass<SessionLoadError>()(\n  'SessionLoadError',\n  {\n    sessionId: Schema.String,\n    message: Schema.String\n  }\n) {}\n\nexport class SessionSaveError extends Schema.TaggedErrorClass<SessionSaveError>()(\n  'SessionSaveError',\n  {\n    sessionId: Schema.String,\n    message: Schema.String\n  }\n) {}\n\nexport class SessionConflictError extends Schema.TaggedErrorClass<SessionConflictError>()(\n  'SessionConflictError',\n  {\n    sessionId: Schema.String,\n    message: Schema.String\n  }\n) {}\n\nexport type RuntimeError =\n  | SessionNotFoundError\n  | SessionLoadError\n  | SessionSaveError\n  | SessionConflictError\n\nexport const runtimeErrorToAgentError = (error: RuntimeError | AgentLoopError): AgentError => {\n  switch (error._tag) {\n    case 'SessionNotFoundError':\n      return AgentError.make({\n        code: 'session_not_found',\n        message: `Session not found: ${error.sessionId}`,\n        retryable: false\n      })\n    case 'SessionLoadError':\n    case 'SessionSaveError':\n      return AgentError.make({\n        code: 'store_error',\n        message: error.message,\n        retryable: true\n      })\n    case 'SessionConflictError':\n      return AgentError.make({\n        code: 'conflict',\n        message: error.message,\n        retryable: false\n      })\n    case 'LLMError':\n    case 'ToolError':\n    case 'ContextTransformError':\n    case 'AbortError':\n    case 'FauxExhaustedError':\n      return agentLoopErrorToAgentError(error)\n  }\n}\n"],"mappings":";;;;AAIA,IAAa,uBAAb,cAA0C,OAAO,iBAAuC,EACtF,wBACA,EACE,WAAW,OAAO,OACpB,CACF,EAAE,CAAC;AAEH,IAAa,mBAAb,cAAsC,OAAO,iBAAmC,EAC9E,oBACA;CACE,WAAW,OAAO;CAClB,SAAS,OAAO;AAClB,CACF,EAAE,CAAC;AAEH,IAAa,mBAAb,cAAsC,OAAO,iBAAmC,EAC9E,oBACA;CACE,WAAW,OAAO;CAClB,SAAS,OAAO;AAClB,CACF,EAAE,CAAC;AAEH,IAAa,uBAAb,cAA0C,OAAO,iBAAuC,EACtF,wBACA;CACE,WAAW,OAAO;CAClB,SAAS,OAAO;AAClB,CACF,EAAE,CAAC;AAQH,MAAa,4BAA4B,UAAqD;CAC5F,QAAQ,MAAM,MAAd;EACE,KAAK,wBACH,OAAO,WAAW,KAAK;GACrB,MAAM;GACN,SAAS,sBAAsB,MAAM;GACrC,WAAW;EACb,CAAC;EACH,KAAK;EACL,KAAK,oBACH,OAAO,WAAW,KAAK;GACrB,MAAM;GACN,SAAS,MAAM;GACf,WAAW;EACb,CAAC;EACH,KAAK,wBACH,OAAO,WAAW,KAAK;GACrB,MAAM;GACN,SAAS,MAAM;GACf,WAAW;EACb,CAAC;EACH,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,sBACH,OAAO,2BAA2B,KAAK;CAC3C;AACF"}

package/dist/runtime/index.d.mts

@@ -0,0 +1,9 @@
+import { RuntimeError, SessionConflictError, SessionLoadError, SessionNotFoundError, SessionSaveError, runtimeErrorToAgentError } from "./error.mjs";
+import { AppendRuntimeSessionEventsInput, HitlResponseAppended, IncompleteRuntimeRun, InputAppended, RunAwaitingInput, RunCompleted, RunFailed, RunInterrupted, RunStarted, RuntimeSessionEvent, RuntimeSessionEventLog, SessionEventStore, SessionEventStoreApi, SessionRevision, StoredRuntimeSessionEvent, appendRuntimeSessionEventsToLog, latestIncompleteRuntimeRun, makeInMemorySessionEventStoreLayer, replayRuntimeHitlResponses, replayRuntimeSessionEvents } from "./session-event-store.mjs";
+import { AppendHitlResponseRuntimeRequest, AppendInputRuntimeRequest, RuntimeConfig, RuntimeRequest, RuntimeTranscript, TranscriptRuntimeRequest, runRuntime } from "./run-runtime.mjs";
+
+//#region src/runtime/index.d.ts
+type RuntimeSessionId = string;
+//#endregion
+export { type AppendHitlResponseRuntimeRequest, type AppendInputRuntimeRequest, type AppendRuntimeSessionEventsInput, HitlResponseAppended, type IncompleteRuntimeRun, InputAppended, RunAwaitingInput, RunCompleted, RunFailed, RunInterrupted, RunStarted, type RuntimeConfig, type RuntimeError, type RuntimeRequest, RuntimeSessionEvent, type RuntimeSessionEventLog, RuntimeSessionId, type RuntimeTranscript, SessionConflictError, SessionEventStore, type SessionEventStoreApi, SessionLoadError, SessionNotFoundError, type SessionRevision, SessionSaveError, type StoredRuntimeSessionEvent, type TranscriptRuntimeRequest, appendRuntimeSessionEventsToLog, latestIncompleteRuntimeRun, makeInMemorySessionEventStoreLayer, replayRuntimeHitlResponses, replayRuntimeSessionEvents, runRuntime, runtimeErrorToAgentError };
+//# sourceMappingURL=index.d.mts.map

package/dist/runtime/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/runtime/index.ts"],"mappings":";;;;;KA0CY,gBAAA"}

package/dist/runtime/index.mjs

@@ -0,0 +1,4 @@
+import { SessionConflictError, SessionLoadError, SessionNotFoundError, SessionSaveError, runtimeErrorToAgentError } from "./error.mjs";
+import { HitlResponseAppended, InputAppended, RunAwaitingInput, RunCompleted, RunFailed, RunInterrupted, RunStarted, RuntimeSessionEvent, SessionEventStore, appendRuntimeSessionEventsToLog, latestIncompleteRuntimeRun, makeInMemorySessionEventStoreLayer, replayRuntimeHitlResponses, replayRuntimeSessionEvents } from "./session-event-store.mjs";
+import { runRuntime } from "./run-runtime.mjs";
+export { HitlResponseAppended, InputAppended, RunAwaitingInput, RunCompleted, RunFailed, RunInterrupted, RunStarted, RuntimeSessionEvent, SessionConflictError, SessionEventStore, SessionLoadError, SessionNotFoundError, SessionSaveError, appendRuntimeSessionEventsToLog, latestIncompleteRuntimeRun, makeInMemorySessionEventStoreLayer, replayRuntimeHitlResponses, replayRuntimeSessionEvents, runRuntime, runtimeErrorToAgentError };

package/dist/runtime/run-runtime.d.mts

@@ -0,0 +1,47 @@
+import { RuntimeError } from "./error.mjs";
+import { SessionEventStore, SessionRevision } from "./session-event-store.mjs";
+import { Stream } from "effect";
+import { AgentEvent, AgentMessage, AgentModelCapabilities, AgentReasoningEffort, HitlResponse, ToolDef } from "@yolk-sdk/agent/protocol";
+import { AgentLoopError, ContextTransformer, LLMProvider, LoopConfig, ToolExecutor } from "@yolk-sdk/agent/loop";
+
+//#region src/runtime/run-runtime.d.ts
+type RuntimeTranscript = readonly [AgentMessage, ...Array<AgentMessage>];
+type RuntimeConfig = {
+  readonly systemPrompt: string;
+  readonly tools: ReadonlyArray<ToolDef>;
+  readonly hitlResponses?: ReadonlyArray<HitlResponse>;
+  readonly model: string;
+  readonly reasoningEffort?: AgentReasoningEffort;
+  readonly capabilities?: AgentModelCapabilities;
+};
+type TranscriptRuntimeRequest = {
+  readonly _tag: 'Transcript';
+  readonly sessionId: string;
+  readonly messages: RuntimeTranscript;
+};
+type AppendInputRuntimeRequest = {
+  readonly _tag: 'AppendInput';
+  readonly sessionId: string;
+  readonly input: AgentMessage;
+  readonly runId: string;
+  readonly expectedRevision?: SessionRevision;
+};
+type AppendHitlResponseRuntimeRequest = {
+  readonly _tag: 'AppendHitlResponse';
+  readonly sessionId: string;
+  readonly response: HitlResponse;
+  readonly runId: string;
+  readonly expectedRevision?: SessionRevision;
+};
+type RuntimeRequest = TranscriptRuntimeRequest | AppendInputRuntimeRequest | AppendHitlResponseRuntimeRequest;
+type LoopRequirements = ContextTransformer | LLMProvider | LoopConfig | ToolExecutor;
+type AppendRuntimeRequirements = LoopRequirements | SessionEventStore;
+type RuntimeRequirements = LoopRequirements | AppendRuntimeRequirements;
+type RuntimeErrorUnion = RuntimeError | AgentLoopError;
+declare function runRuntime(request: TranscriptRuntimeRequest, config: RuntimeConfig): Stream.Stream<AgentEvent, AgentLoopError, LoopRequirements>;
+declare function runRuntime(request: AppendInputRuntimeRequest, config: RuntimeConfig): Stream.Stream<AgentEvent, RuntimeErrorUnion, AppendRuntimeRequirements>;
+declare function runRuntime(request: AppendHitlResponseRuntimeRequest, config: RuntimeConfig): Stream.Stream<AgentEvent, RuntimeErrorUnion, AppendRuntimeRequirements>;
+declare function runRuntime(request: RuntimeRequest, config: RuntimeConfig): Stream.Stream<AgentEvent, RuntimeErrorUnion, RuntimeRequirements>;
+//#endregion
+export { AppendHitlResponseRuntimeRequest, AppendInputRuntimeRequest, RuntimeConfig, RuntimeRequest, RuntimeTranscript, TranscriptRuntimeRequest, runRuntime };
+//# sourceMappingURL=run-runtime.d.mts.map

package/dist/runtime/run-runtime.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-runtime.d.mts","names":[],"sources":["../../src/runtime/run-runtime.ts"],"mappings":";;;;;;;KAkCY,iBAAA,aAA8B,YAAA,KAAiB,KAAA,CAAM,YAAA;AAAA,KAErD,aAAA;EAAA,SACD,YAAA;EAAA,SACA,KAAA,EAAO,aAAA,CAAc,OAAA;EAAA,SACrB,aAAA,GAAgB,aAAA,CAAc,YAAA;EAAA,SAC9B,KAAA;EAAA,SACA,eAAA,GAAkB,oBAAA;EAAA,SAClB,YAAA,GAAe,sBAAA;AAAA;AAAA,KAGd,wBAAA;EAAA,SACD,IAAA;EAAA,SACA,SAAA;EAAA,SACA,QAAA,EAAU,iBAAiB;AAAA;AAAA,KAG1B,yBAAA;EAAA,SACD,IAAA;EAAA,SACA,SAAA;EAAA,SACA,KAAA,EAAO,YAAA;EAAA,SACP,KAAA;EAAA,SACA,gBAAA,GAAmB,eAAe;AAAA;AAAA,KAGjC,gCAAA;EAAA,SACD,IAAA;EAAA,SACA,SAAA;EAAA,SACA,QAAA,EAAU,YAAA;EAAA,SACV,KAAA;EAAA,SACA,gBAAA,GAAmB,eAAe;AAAA;AAAA,KAGjC,cAAA,GACR,wBAAA,GACA,yBAAA,GACA,gCAAA;AAAA,KAEC,gBAAA,GAAmB,kBAAA,GAAqB,WAAA,GAAc,UAAA,GAAa,YAAA;AAAA,KACnE,yBAAA,GAA4B,gBAAA,GAAmB,iBAAiB;AAAA,KAChE,mBAAA,GAAsB,gBAAA,GAAmB,yBAAyB;AAAA,KAClE,iBAAA,GAAoB,YAAA,GAAe,cAAc;AAAA,iBA2MtC,UAAA,CACd,OAAA,EAAS,wBAAA,EACT,MAAA,EAAQ,aAAA,GACP,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,cAAA,EAAgB,gBAAA;AAAA,iBAC7B,UAAA,CACd,OAAA,EAAS,yBAAA,EACT,MAAA,EAAQ,aAAA,GACP,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,iBAAA,EAAmB,yBAAA;AAAA,iBAChC,UAAA,CACd,OAAA,EAAS,gCAAA,EACT,MAAA,EAAQ,aAAA,GACP,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,iBAAA,EAAmB,yBAAA;AAAA,iBAChC,UAAA,CACd,OAAA,EAAS,cAAA,EACT,MAAA,EAAQ,aAAA,GACP,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,iBAAA,EAAmB,mBAAA"}