@redtuma/core 0.1.0

package/dist/message-list.d.ts

@@ -0,0 +1,37 @@
+import { CoreMessage } from "ai";
+
+//#region src/message-list.d.ts
+type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+/** Canonical persisted message shape. */
+interface RedtumaMessage {
+  id: string;
+  role: MessageRole;
+  content: CoreMessage['content'];
+  createdAt: Date;
+  threadId?: string;
+  resourceId?: string;
+}
+type MessageInput = string | CoreMessage | CoreMessage[] | RedtumaMessage | RedtumaMessage[];
+/**
+ * Normalizes heterogeneous message inputs (strings, AI SDK CoreMessages,
+ * persisted RedtumaMessages) into a single ordered list and converts back to
+ * the AI SDK `CoreMessage[]` shape for model calls.
+ */
+declare class MessageList {
+  private readonly meta;
+  private messages;
+  constructor(meta?: {
+    threadId?: string;
+    resourceId?: string;
+  });
+  add(input: MessageInput, role?: MessageRole): this;
+  private coerce;
+  private wrap;
+  all(): RedtumaMessage[];
+  /** Convert to AI SDK CoreMessage[] (drops redtuma-only metadata). */
+  toCore(): CoreMessage[];
+  get length(): number;
+}
+//#endregion
+export { MessageInput, MessageList, MessageRole, RedtumaMessage };
+//# sourceMappingURL=message-list.d.ts.map

package/dist/message-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-list.d.ts","names":[],"sources":["../src/message-list.ts"],"sourcesContent":[],"mappings":";;;KAEY,WAAA;;AAAA,UAGK,cAAA,CAHM;EAGN,EAAA,EAAA,MAAA;EAET,IAAA,EAAA,WAAA;EACG,OAAA,EAAA,WAAA,CAAA,SAAA,CAAA;EACE,SAAA,EAAA,IAAA;EAAI,QAAA,CAAA,EAAA,MAAA;EAKL,UAAA,CAAA,EAAA,MAAY;;AAGpB,KAHQ,YAAA,GAGR,MAAA,GADA,WACA,GAAA,WAAA,EAAA,GACA,cADA,GAEA,cAFA,EAAA;;;;AAmBJ;;AAOiC,cAPpB,WAAA,CAOoB;EA4BxB,iBAAA,IAAA;EAKG,QAAA,QAAA;EAAW,WAAA,CAAA,KAAA,EAAA;;;;aAjCV,qBAAoB;;;SA4BxB;;YAKG"}

package/dist/message-list.js

@@ -0,0 +1,61 @@
+//#region src/message-list.ts
+let counter = 0;
+function genId() {
+	counter += 1;
+	return `msg_${Date.now().toString(36)}_${counter.toString(36)}`;
+}
+function isRedtumaMessage(m) {
+	return !!m && typeof m === "object" && "createdAt" in m && "id" in m && "role" in m;
+}
+/**
+* Normalizes heterogeneous message inputs (strings, AI SDK CoreMessages,
+* persisted RedtumaMessages) into a single ordered list and converts back to
+* the AI SDK `CoreMessage[]` shape for model calls.
+*/
+var MessageList = class {
+	messages = [];
+	constructor(meta = {}) {
+		this.meta = meta;
+	}
+	add(input, role = "user") {
+		for (const m of this.coerce(input, role)) this.messages.push(m);
+		return this;
+	}
+	coerce(input, role) {
+		if (typeof input === "string") return [this.wrap({
+			role,
+			content: input
+		})];
+		return (Array.isArray(input) ? input : [input]).map((m) => isRedtumaMessage(m) ? m : this.wrap({
+			role: m.role,
+			content: m.content
+		}));
+	}
+	wrap(m) {
+		return {
+			id: genId(),
+			role: m.role,
+			content: m.content,
+			createdAt: /* @__PURE__ */ new Date(),
+			threadId: this.meta.threadId,
+			resourceId: this.meta.resourceId
+		};
+	}
+	all() {
+		return [...this.messages];
+	}
+	/** Convert to AI SDK CoreMessage[] (drops redtuma-only metadata). */
+	toCore() {
+		return this.messages.map((m) => ({
+			role: m.role,
+			content: m.content
+		}));
+	}
+	get length() {
+		return this.messages.length;
+	}
+};
+
+//#endregion
+export { MessageList };
+//# sourceMappingURL=message-list.js.map

package/dist/message-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-list.js","names":["meta: { threadId?: string; resourceId?: string }"],"sources":["../src/message-list.ts"],"sourcesContent":["import type { CoreMessage } from 'ai'\n\nexport type MessageRole = 'system' | 'user' | 'assistant' | 'tool'\n\n/** Canonical persisted message shape. */\nexport interface RedtumaMessage {\n  id: string\n  role: MessageRole\n  content: CoreMessage['content']\n  createdAt: Date\n  threadId?: string\n  resourceId?: string\n}\n\nexport type MessageInput =\n  | string\n  | CoreMessage\n  | CoreMessage[]\n  | RedtumaMessage\n  | RedtumaMessage[]\n\nlet counter = 0\nfunction genId(): string {\n  counter += 1\n  return `msg_${Date.now().toString(36)}_${counter.toString(36)}`\n}\n\nfunction isRedtumaMessage(m: unknown): m is RedtumaMessage {\n  return !!m && typeof m === 'object' && 'createdAt' in m && 'id' in m && 'role' in m\n}\n\n/**\n * Normalizes heterogeneous message inputs (strings, AI SDK CoreMessages,\n * persisted RedtumaMessages) into a single ordered list and converts back to\n * the AI SDK `CoreMessage[]` shape for model calls.\n */\nexport class MessageList {\n  private messages: RedtumaMessage[] = []\n\n  constructor(\n    private readonly meta: { threadId?: string; resourceId?: string } = {},\n  ) {}\n\n  add(input: MessageInput, role: MessageRole = 'user'): this {\n    for (const m of this.coerce(input, role)) this.messages.push(m)\n    return this\n  }\n\n  private coerce(input: MessageInput, role: MessageRole): RedtumaMessage[] {\n    if (typeof input === 'string') {\n      return [this.wrap({ role, content: input })]\n    }\n    const arr = Array.isArray(input) ? input : [input]\n    return arr.map((m) =>\n      isRedtumaMessage(m)\n        ? m\n        : this.wrap({ role: m.role as MessageRole, content: m.content }),\n    )\n  }\n\n  private wrap(m: { role: MessageRole; content: CoreMessage['content'] }): RedtumaMessage {\n    return {\n      id: genId(),\n      role: m.role,\n      content: m.content,\n      createdAt: new Date(),\n      threadId: this.meta.threadId,\n      resourceId: this.meta.resourceId,\n    }\n  }\n\n  all(): RedtumaMessage[] {\n    return [...this.messages]\n  }\n\n  /** Convert to AI SDK CoreMessage[] (drops redtuma-only metadata). */\n  toCore(): CoreMessage[] {\n    return this.messages.map(\n      (m) => ({ role: m.role, content: m.content }) as CoreMessage,\n    )\n  }\n\n  get length(): number {\n    return this.messages.length\n  }\n}\n"],"mappings":";AAqBA,IAAI,UAAU;AACd,SAAS,QAAgB;AACvB,YAAW;AACX,QAAO,OAAO,KAAK,KAAK,CAAC,SAAS,GAAG,CAAC,GAAG,QAAQ,SAAS,GAAG;;AAG/D,SAAS,iBAAiB,GAAiC;AACzD,QAAO,CAAC,CAAC,KAAK,OAAO,MAAM,YAAY,eAAe,KAAK,QAAQ,KAAK,UAAU;;;;;;;AAQpF,IAAa,cAAb,MAAyB;CACvB,AAAQ,WAA6B,EAAE;CAEvC,YACE,AAAiBA,OAAmD,EAAE,EACtE;EADiB;;CAGnB,IAAI,OAAqB,OAAoB,QAAc;AACzD,OAAK,MAAM,KAAK,KAAK,OAAO,OAAO,KAAK,CAAE,MAAK,SAAS,KAAK,EAAE;AAC/D,SAAO;;CAGT,AAAQ,OAAO,OAAqB,MAAqC;AACvE,MAAI,OAAO,UAAU,SACnB,QAAO,CAAC,KAAK,KAAK;GAAE;GAAM,SAAS;GAAO,CAAC,CAAC;AAG9C,UADY,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM,EACvC,KAAK,MACd,iBAAiB,EAAE,GACf,IACA,KAAK,KAAK;GAAE,MAAM,EAAE;GAAqB,SAAS,EAAE;GAAS,CAAC,CACnE;;CAGH,AAAQ,KAAK,GAA2E;AACtF,SAAO;GACL,IAAI,OAAO;GACX,MAAM,EAAE;GACR,SAAS,EAAE;GACX,2BAAW,IAAI,MAAM;GACrB,UAAU,KAAK,KAAK;GACpB,YAAY,KAAK,KAAK;GACvB;;CAGH,MAAwB;AACtB,SAAO,CAAC,GAAG,KAAK,SAAS;;;CAI3B,SAAwB;AACtB,SAAO,KAAK,SAAS,KAClB,OAAO;GAAE,MAAM,EAAE;GAAM,SAAS,EAAE;GAAS,EAC7C;;CAGH,IAAI,SAAiB;AACnB,SAAO,KAAK,SAAS"}

package/dist/redtuma.d.ts

@@ -0,0 +1,35 @@
+import { Logger } from "./types.js";
+import { AnyToolAction } from "./tools/index.js";
+import { Agent, AgentMemory } from "./agent/index.js";
+import { Workflow } from "./workflows/index.js";
+import { Store } from "./store/index.js";
+
+//#region src/redtuma.d.ts
+interface RedtumaConfig {
+  agents?: Record<string, Agent>;
+  workflows?: Record<string, Workflow>;
+  tools?: Record<string, AnyToolAction>;
+  storage?: Store;
+  memory?: AgentMemory;
+  logger?: Logger;
+}
+/**
+ * Central registry and orchestrator. Wires shared dependencies (logger, memory,
+ * storage) into every registered component.
+ */
+declare class Redtuma {
+  #private;
+  constructor(config?: RedtumaConfig);
+  getAgent(key: string): Agent;
+  /** Look up an agent by its `id` property (may differ from the registry key). */
+  getAgentById(id: string): Agent;
+  getAgents(): Record<string, Agent>;
+  getWorkflow(key: string): Workflow;
+  getWorkflows(): Record<string, Workflow>;
+  getTool(key: string): AnyToolAction;
+  getStorage(): Store | undefined;
+  getLogger(): Logger;
+}
+//#endregion
+export { Redtuma, RedtumaConfig };
+//# sourceMappingURL=redtuma.d.ts.map

package/dist/redtuma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redtuma.d.ts","names":[],"sources":["../src/redtuma.ts"],"sourcesContent":[],"mappings":";;;;;;;UAOiB,aAAA;WACN,eAAe;EADT,SAAA,CAAA,EAEH,MAFgB,CAAA,MAAA,EAED,QAFC,CAAA;EACJ,KAAA,CAAA,EAEhB,MAFgB,CAAA,MAAA,EAED,aAFC,CAAA;EAAf,OAAA,CAAA,EAGC,KAHD;EACkB,MAAA,CAAA,EAGlB,WAHkB;EAAf,MAAA,CAAA,EAIH,MAJG;;;;;;AAIG,cAOJ,OAAA,CAPI;EAOJ,CAAA,OAAA;EAQS,WAAA,CAAA,MAAA,CAAA,EAAA,aAAA;EAgBG,QAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,KAAA;EAOG;EAME,YAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EANF,KAME;EAAf,SAAA,CAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAe,KAAf,CAAA;EAIa,WAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,QAAA;EAMK,YAAA,CAAA,CAAA,EAAf,MAAe,CAAA,MAAA,EAAA,QAAA,CAAA;EAAf,OAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAIM,aAJN;EAIM,UAAA,CAAA,CAAA,EAMR,KANQ,GAAA,SAAA;EAMR,SAAA,CAAA,CAAA,EAID,MAJC"}

package/dist/redtuma.js

@@ -0,0 +1,65 @@
+import { ConsoleLogger } from "./logger.js";
+
+//#region src/redtuma.ts
+/**
+* Central registry and orchestrator. Wires shared dependencies (logger, memory,
+* storage) into every registered component.
+*/
+var Redtuma = class {
+	#agents;
+	#workflows;
+	#tools;
+	#storage;
+	#memory;
+	#logger;
+	constructor(config = {}) {
+		this.#agents = config.agents ?? {};
+		this.#workflows = config.workflows ?? {};
+		this.#tools = config.tools ?? {};
+		this.#storage = config.storage;
+		this.#memory = config.memory;
+		this.#logger = config.logger ?? new ConsoleLogger("info");
+		for (const agent of Object.values(this.#agents)) agent.__register({
+			logger: this.#logger,
+			memory: this.#memory
+		});
+		for (const wf of Object.values(this.#workflows)) wf.logger = this.#logger;
+	}
+	getAgent(key) {
+		const agent = this.#agents[key];
+		if (!agent) throw new Error(`Agent "${key}" is not registered.`);
+		return agent;
+	}
+	/** Look up an agent by its `id` property (may differ from the registry key). */
+	getAgentById(id) {
+		const found = Object.values(this.#agents).find((a) => a.id === id);
+		if (!found) throw new Error(`Agent with id "${id}" is not registered.`);
+		return found;
+	}
+	getAgents() {
+		return { ...this.#agents };
+	}
+	getWorkflow(key) {
+		const wf = this.#workflows[key];
+		if (!wf) throw new Error(`Workflow "${key}" is not registered.`);
+		return wf;
+	}
+	getWorkflows() {
+		return { ...this.#workflows };
+	}
+	getTool(key) {
+		const tool = this.#tools[key];
+		if (!tool) throw new Error(`Tool "${key}" is not registered.`);
+		return tool;
+	}
+	getStorage() {
+		return this.#storage;
+	}
+	getLogger() {
+		return this.#logger;
+	}
+};
+
+//#endregion
+export { Redtuma };
+//# sourceMappingURL=redtuma.js.map

package/dist/redtuma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redtuma.js","names":["#agents","#workflows","#tools","#storage","#memory","#logger"],"sources":["../src/redtuma.ts"],"sourcesContent":["import { Agent, type AgentMemory } from './agent'\nimport type { Workflow } from './workflows'\nimport type { AnyToolAction } from './tools'\nimport type { Store } from './store'\nimport { ConsoleLogger } from './logger'\nimport type { Logger } from './types'\n\nexport interface RedtumaConfig {\n  agents?: Record<string, Agent>\n  workflows?: Record<string, Workflow>\n  tools?: Record<string, AnyToolAction>\n  storage?: Store\n  memory?: AgentMemory\n  logger?: Logger\n}\n\n/**\n * Central registry and orchestrator. Wires shared dependencies (logger, memory,\n * storage) into every registered component.\n */\nexport class Redtuma {\n  #agents: Record<string, Agent>\n  #workflows: Record<string, Workflow>\n  #tools: Record<string, AnyToolAction>\n  #storage?: Store\n  #memory?: AgentMemory\n  #logger: Logger\n\n  constructor(config: RedtumaConfig = {}) {\n    this.#agents = config.agents ?? {}\n    this.#workflows = config.workflows ?? {}\n    this.#tools = config.tools ?? {}\n    this.#storage = config.storage\n    this.#memory = config.memory\n    this.#logger = config.logger ?? new ConsoleLogger('info')\n\n    for (const agent of Object.values(this.#agents)) {\n      agent.__register({ logger: this.#logger, memory: this.#memory })\n    }\n    for (const wf of Object.values(this.#workflows)) {\n      wf.logger = this.#logger\n    }\n  }\n\n  getAgent(key: string): Agent {\n    const agent = this.#agents[key]\n    if (!agent) throw new Error(`Agent \"${key}\" is not registered.`)\n    return agent\n  }\n\n  /** Look up an agent by its `id` property (may differ from the registry key). */\n  getAgentById(id: string): Agent {\n    const found = Object.values(this.#agents).find((a) => a.id === id)\n    if (!found) throw new Error(`Agent with id \"${id}\" is not registered.`)\n    return found\n  }\n\n  getAgents(): Record<string, Agent> {\n    return { ...this.#agents }\n  }\n\n  getWorkflow(key: string): Workflow {\n    const wf = this.#workflows[key]\n    if (!wf) throw new Error(`Workflow \"${key}\" is not registered.`)\n    return wf\n  }\n\n  getWorkflows(): Record<string, Workflow> {\n    return { ...this.#workflows }\n  }\n\n  getTool(key: string): AnyToolAction {\n    const tool = this.#tools[key]\n    if (!tool) throw new Error(`Tool \"${key}\" is not registered.`)\n    return tool\n  }\n\n  getStorage(): Store | undefined {\n    return this.#storage\n  }\n\n  getLogger(): Logger {\n    return this.#logger\n  }\n}\n"],"mappings":";;;;;;;AAoBA,IAAa,UAAb,MAAqB;CACnB;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,SAAwB,EAAE,EAAE;AACtC,QAAKA,SAAU,OAAO,UAAU,EAAE;AAClC,QAAKC,YAAa,OAAO,aAAa,EAAE;AACxC,QAAKC,QAAS,OAAO,SAAS,EAAE;AAChC,QAAKC,UAAW,OAAO;AACvB,QAAKC,SAAU,OAAO;AACtB,QAAKC,SAAU,OAAO,UAAU,IAAI,cAAc,OAAO;AAEzD,OAAK,MAAM,SAAS,OAAO,OAAO,MAAKL,OAAQ,CAC7C,OAAM,WAAW;GAAE,QAAQ,MAAKK;GAAS,QAAQ,MAAKD;GAAS,CAAC;AAElE,OAAK,MAAM,MAAM,OAAO,OAAO,MAAKH,UAAW,CAC7C,IAAG,SAAS,MAAKI;;CAIrB,SAAS,KAAoB;EAC3B,MAAM,QAAQ,MAAKL,OAAQ;AAC3B,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,UAAU,IAAI,sBAAsB;AAChE,SAAO;;;CAIT,aAAa,IAAmB;EAC9B,MAAM,QAAQ,OAAO,OAAO,MAAKA,OAAQ,CAAC,MAAM,MAAM,EAAE,OAAO,GAAG;AAClE,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,kBAAkB,GAAG,sBAAsB;AACvE,SAAO;;CAGT,YAAmC;AACjC,SAAO,EAAE,GAAG,MAAKA,QAAS;;CAG5B,YAAY,KAAuB;EACjC,MAAM,KAAK,MAAKC,UAAW;AAC3B,MAAI,CAAC,GAAI,OAAM,IAAI,MAAM,aAAa,IAAI,sBAAsB;AAChE,SAAO;;CAGT,eAAyC;AACvC,SAAO,EAAE,GAAG,MAAKA,WAAY;;CAG/B,QAAQ,KAA4B;EAClC,MAAM,OAAO,MAAKC,MAAO;AACzB,MAAI,CAAC,KAAM,OAAM,IAAI,MAAM,SAAS,IAAI,sBAAsB;AAC9D,SAAO;;CAGT,aAAgC;AAC9B,SAAO,MAAKC;;CAGd,YAAoB;AAClB,SAAO,MAAKE"}

package/dist/store/index.d.ts

@@ -0,0 +1,57 @@
+import { RedtumaMessage } from "../message-list.js";
+
+//#region src/store/index.d.ts
+interface Thread {
+  id: string;
+  resourceId: string;
+  title?: string;
+  metadata?: Record<string, unknown>;
+  createdAt: Date;
+  updatedAt: Date;
+}
+interface Resource {
+  id: string;
+  workingMemory?: string;
+  metadata?: Record<string, unknown>;
+}
+interface GetMessagesArgs {
+  threadId: string;
+  /** Return only the most recent N messages. */
+  last?: number;
+}
+/** Persistence interface shared by all store adapters. */
+interface Store {
+  saveThread(thread: Thread): Promise<Thread>;
+  getThread(id: string): Promise<Thread | null>;
+  getThreadsByResourceId(resourceId: string): Promise<Thread[]>;
+  deleteThread(id: string): Promise<void>;
+  saveMessages(messages: RedtumaMessage[]): Promise<RedtumaMessage[]>;
+  getMessages(args: GetMessagesArgs): Promise<RedtumaMessage[]>;
+  getResource(id: string): Promise<Resource | null>;
+  saveResource(resource: Resource): Promise<Resource>;
+  persistSnapshot(key: string, value: unknown): Promise<void>;
+  loadSnapshot<T = unknown>(key: string): Promise<T | null>;
+}
+/** Default ephemeral store. Useful for tests and quick starts. */
+declare class InMemoryStore implements Store {
+  private threads;
+  private messages;
+  private resources;
+  private snapshots;
+  saveThread(thread: Thread): Promise<Thread>;
+  getThread(id: string): Promise<Thread | null>;
+  getThreadsByResourceId(resourceId: string): Promise<Thread[]>;
+  deleteThread(id: string): Promise<void>;
+  saveMessages(messages: RedtumaMessage[]): Promise<RedtumaMessage[]>;
+  getMessages({
+    threadId,
+    last
+  }: GetMessagesArgs): Promise<RedtumaMessage[]>;
+  getResource(id: string): Promise<Resource | null>;
+  saveResource(resource: Resource): Promise<Resource>;
+  persistSnapshot(key: string, value: unknown): Promise<void>;
+  loadSnapshot<T = unknown>(key: string): Promise<T | null>;
+}
+//#endregion
+export { GetMessagesArgs, InMemoryStore, Resource, Store, Thread };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/store/index.ts"],"sourcesContent":[],"mappings":";;;UAEiB,MAAA;;EAAA,UAAM,EAAA,MAAA;EAIV,KAAA,CAAA,EAAA,MAAA;EACA,QAAA,CAAA,EADA,MACA,CAAA,MAAA,EAAA,OAAA,CAAA;EACA,SAAA,EADA,IACA;EAAI,SAAA,EAAJ,IAAI;AAGjB;AAMiB,UANA,QAAA,CAMe;EAOf,EAAA,EAAA,MAAK;EAED,aAAA,CAAA,EAAA,MAAA;EAAiB,QAAA,CAAA,EAZzB,MAYyB,CAAA,MAAA,EAAA,OAAA,CAAA;;AACL,UAVhB,eAAA,CAUgB;EAAR,QAAA,EAAA,MAAA;EAC6B;EAAR,IAAA,CAAA,EAAA,MAAA;;;AAGM,UAPnC,KAAA,CAOmC;EAAR,UAAA,CAAA,MAAA,EALvB,MAKuB,CAAA,EALd,OAKc,CALN,MAKM,CAAA;EACxB,SAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EALK,OAKL,CALa,MAKb,GAAA,IAAA,CAAA;EAA0B,sBAAA,CAAA,UAAA,EAAA,MAAA,CAAA,EAJA,OAIA,CAJQ,MAIR,EAAA,CAAA;EAAR,YAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAHV,OAGU,CAAA,IAAA,CAAA;EAEH,YAAA,CAAA,QAAA,EAHV,cAGU,EAAA,CAAA,EAHS,OAGT,CAHiB,cAGjB,EAAA,CAAA;EAAR,WAAA,CAAA,IAAA,EAFP,eAEO,CAAA,EAFW,OAEX,CAFmB,cAEnB,EAAA,CAAA;EACF,WAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EADE,OACF,CADU,QACV,GAAA,IAAA,CAAA;EAAmB,YAAA,CAAA,QAAA,EAAnB,QAAmB,CAAA,EAAR,OAAQ,CAAA,QAAA,CAAA;EAAR,eAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,OAAA,CAAA,EAEY,OAFZ,CAAA,IAAA,CAAA;EAEY,YAAA,CAAA,IAAA,OAAA,CAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EACN,OADM,CACE,CADF,GAAA,IAAA,CAAA;;;AACC,cAIpC,aAAA,YAAyB,KAJW,CAAA;EAIpC,QAAA,OAAA;EAMc,QAAA,QAAA;EAAiB,QAAA,SAAA;EAAR,QAAA,SAAA;EAKG,UAAA,CAAA,MAAA,EALZ,MAKY,CAAA,EALH,OAKG,CALK,MAKL,CAAA;EAAR,SAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAAA,OAAA,CAAQ,MAAR,GAAA,IAAA,CAAA;EAG6B,sBAAA,CAAA,UAAA,EAAA,MAAA,CAAA,EAAR,OAAQ,CAAA,MAAA,EAAA,CAAA;EAAR,YAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAGlB,OAHkB,CAAA,IAAA,CAAA;EAGlB,YAAA,CAAA,QAAA,EAKH,cALG,EAAA,CAAA,EAKgB,OALhB,CAKwB,cALxB,EAAA,CAAA;EAKH,WAAA,CAAA;IAAA,QAAA;IAAA;EAAA,CAAA,EASS,eATT,CAAA,EAS2B,OAT3B,CASmC,cATnC,EAAA,CAAA;EAA2B,WAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAczB,OAdyB,CAcjB,QAdiB,GAAA,IAAA,CAAA;EAAR,YAAA,CAAA,QAAA,EAiBnB,QAjBmB,CAAA,EAiBR,OAjBQ,CAiBA,QAjBA,CAAA;EAS5B,eAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,OAAA,CAAA,EAagC,OAbhC,CAAA,IAAA,CAAA;EAAU,YAAA,CAAA,IAAA,OAAA,CAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAgBgB,OAhBhB,CAgBwB,CAhBxB,GAAA,IAAA,CAAA"}

package/dist/store/index.js

@@ -0,0 +1,53 @@
+//#region src/store/index.ts
+/** Default ephemeral store. Useful for tests and quick starts. */
+var InMemoryStore = class {
+	threads = /* @__PURE__ */ new Map();
+	messages = /* @__PURE__ */ new Map();
+	resources = /* @__PURE__ */ new Map();
+	snapshots = /* @__PURE__ */ new Map();
+	async saveThread(thread) {
+		this.threads.set(thread.id, thread);
+		if (!this.messages.has(thread.id)) this.messages.set(thread.id, []);
+		return thread;
+	}
+	async getThread(id) {
+		return this.threads.get(id) ?? null;
+	}
+	async getThreadsByResourceId(resourceId) {
+		return [...this.threads.values()].filter((t) => t.resourceId === resourceId);
+	}
+	async deleteThread(id) {
+		this.threads.delete(id);
+		this.messages.delete(id);
+	}
+	async saveMessages(messages) {
+		for (const m of messages) {
+			if (!m.threadId) continue;
+			const list = this.messages.get(m.threadId) ?? [];
+			list.push(m);
+			this.messages.set(m.threadId, list);
+		}
+		return messages;
+	}
+	async getMessages({ threadId, last }) {
+		const list = this.messages.get(threadId) ?? [];
+		return typeof last === "number" ? list.slice(-last) : [...list];
+	}
+	async getResource(id) {
+		return this.resources.get(id) ?? null;
+	}
+	async saveResource(resource) {
+		this.resources.set(resource.id, resource);
+		return resource;
+	}
+	async persistSnapshot(key, value) {
+		this.snapshots.set(key, value);
+	}
+	async loadSnapshot(key) {
+		return this.snapshots.get(key) ?? null;
+	}
+};
+
+//#endregion
+export { InMemoryStore };
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/store/index.ts"],"sourcesContent":["import type { RedtumaMessage } from '../message-list'\n\nexport interface Thread {\n  id: string\n  resourceId: string\n  title?: string\n  metadata?: Record<string, unknown>\n  createdAt: Date\n  updatedAt: Date\n}\n\nexport interface Resource {\n  id: string\n  workingMemory?: string\n  metadata?: Record<string, unknown>\n}\n\nexport interface GetMessagesArgs {\n  threadId: string\n  /** Return only the most recent N messages. */\n  last?: number\n}\n\n/** Persistence interface shared by all store adapters. */\nexport interface Store {\n  // threads\n  saveThread(thread: Thread): Promise<Thread>\n  getThread(id: string): Promise<Thread | null>\n  getThreadsByResourceId(resourceId: string): Promise<Thread[]>\n  deleteThread(id: string): Promise<void>\n  // messages\n  saveMessages(messages: RedtumaMessage[]): Promise<RedtumaMessage[]>\n  getMessages(args: GetMessagesArgs): Promise<RedtumaMessage[]>\n  // working memory / resources\n  getResource(id: string): Promise<Resource | null>\n  saveResource(resource: Resource): Promise<Resource>\n  // generic kv for workflow snapshots etc.\n  persistSnapshot(key: string, value: unknown): Promise<void>\n  loadSnapshot<T = unknown>(key: string): Promise<T | null>\n}\n\n/** Default ephemeral store. Useful for tests and quick starts. */\nexport class InMemoryStore implements Store {\n  private threads = new Map<string, Thread>()\n  private messages = new Map<string, RedtumaMessage[]>()\n  private resources = new Map<string, Resource>()\n  private snapshots = new Map<string, unknown>()\n\n  async saveThread(thread: Thread): Promise<Thread> {\n    this.threads.set(thread.id, thread)\n    if (!this.messages.has(thread.id)) this.messages.set(thread.id, [])\n    return thread\n  }\n  async getThread(id: string): Promise<Thread | null> {\n    return this.threads.get(id) ?? null\n  }\n  async getThreadsByResourceId(resourceId: string): Promise<Thread[]> {\n    return [...this.threads.values()].filter((t) => t.resourceId === resourceId)\n  }\n  async deleteThread(id: string): Promise<void> {\n    this.threads.delete(id)\n    this.messages.delete(id)\n  }\n\n  async saveMessages(messages: RedtumaMessage[]): Promise<RedtumaMessage[]> {\n    for (const m of messages) {\n      if (!m.threadId) continue\n      const list = this.messages.get(m.threadId) ?? []\n      list.push(m)\n      this.messages.set(m.threadId, list)\n    }\n    return messages\n  }\n  async getMessages({ threadId, last }: GetMessagesArgs): Promise<RedtumaMessage[]> {\n    const list = this.messages.get(threadId) ?? []\n    return typeof last === 'number' ? list.slice(-last) : [...list]\n  }\n\n  async getResource(id: string): Promise<Resource | null> {\n    return this.resources.get(id) ?? null\n  }\n  async saveResource(resource: Resource): Promise<Resource> {\n    this.resources.set(resource.id, resource)\n    return resource\n  }\n\n  async persistSnapshot(key: string, value: unknown): Promise<void> {\n    this.snapshots.set(key, value)\n  }\n  async loadSnapshot<T = unknown>(key: string): Promise<T | null> {\n    return (this.snapshots.get(key) as T) ?? null\n  }\n}\n"],"mappings":";;AA0CA,IAAa,gBAAb,MAA4C;CAC1C,AAAQ,0BAAU,IAAI,KAAqB;CAC3C,AAAQ,2BAAW,IAAI,KAA+B;CACtD,AAAQ,4BAAY,IAAI,KAAuB;CAC/C,AAAQ,4BAAY,IAAI,KAAsB;CAE9C,MAAM,WAAW,QAAiC;AAChD,OAAK,QAAQ,IAAI,OAAO,IAAI,OAAO;AACnC,MAAI,CAAC,KAAK,SAAS,IAAI,OAAO,GAAG,CAAE,MAAK,SAAS,IAAI,OAAO,IAAI,EAAE,CAAC;AACnE,SAAO;;CAET,MAAM,UAAU,IAAoC;AAClD,SAAO,KAAK,QAAQ,IAAI,GAAG,IAAI;;CAEjC,MAAM,uBAAuB,YAAuC;AAClE,SAAO,CAAC,GAAG,KAAK,QAAQ,QAAQ,CAAC,CAAC,QAAQ,MAAM,EAAE,eAAe,WAAW;;CAE9E,MAAM,aAAa,IAA2B;AAC5C,OAAK,QAAQ,OAAO,GAAG;AACvB,OAAK,SAAS,OAAO,GAAG;;CAG1B,MAAM,aAAa,UAAuD;AACxE,OAAK,MAAM,KAAK,UAAU;AACxB,OAAI,CAAC,EAAE,SAAU;GACjB,MAAM,OAAO,KAAK,SAAS,IAAI,EAAE,SAAS,IAAI,EAAE;AAChD,QAAK,KAAK,EAAE;AACZ,QAAK,SAAS,IAAI,EAAE,UAAU,KAAK;;AAErC,SAAO;;CAET,MAAM,YAAY,EAAE,UAAU,QAAoD;EAChF,MAAM,OAAO,KAAK,SAAS,IAAI,SAAS,IAAI,EAAE;AAC9C,SAAO,OAAO,SAAS,WAAW,KAAK,MAAM,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK;;CAGjE,MAAM,YAAY,IAAsC;AACtD,SAAO,KAAK,UAAU,IAAI,GAAG,IAAI;;CAEnC,MAAM,aAAa,UAAuC;AACxD,OAAK,UAAU,IAAI,SAAS,IAAI,SAAS;AACzC,SAAO;;CAGT,MAAM,gBAAgB,KAAa,OAA+B;AAChE,OAAK,UAAU,IAAI,KAAK,MAAM;;CAEhC,MAAM,aAA0B,KAAgC;AAC9D,SAAQ,KAAK,UAAU,IAAI,IAAI,IAAU"}

package/dist/tools/index.d.ts

@@ -0,0 +1,39 @@
+import { RuntimeContext } from "../types.js";
+import { Tool } from "ai";
+import { z } from "zod";
+
+//#region src/tools/index.d.ts
+interface ToolExecuteContext<TInput> {
+  /** Validated tool input. */
+  context: TInput;
+  runtimeContext: RuntimeContext;
+  abortSignal?: AbortSignal;
+}
+interface ToolAction<TInputSchema extends z.ZodTypeAny = z.ZodTypeAny, TOutputSchema extends z.ZodTypeAny = z.ZodTypeAny> {
+  id: string;
+  description: string;
+  inputSchema: TInputSchema;
+  outputSchema?: TOutputSchema;
+  execute: (ctx: ToolExecuteContext<z.infer<TInputSchema>>) => Promise<unknown> | unknown;
+}
+/** Define a Redtuma tool. The id is used as the tool name presented to the model. */
+declare function createTool<TInputSchema extends z.ZodTypeAny, TOutputSchema extends z.ZodTypeAny = z.ZodTypeAny>(config: {
+  id: string;
+  description: string;
+  inputSchema: TInputSchema;
+  outputSchema?: TOutputSchema;
+  execute: (ctx: ToolExecuteContext<z.infer<TInputSchema>>) => Promise<unknown> | unknown;
+}): ToolAction<TInputSchema, TOutputSchema>;
+/** A tool with its schema generics erased; use for heterogeneous collections. */
+type AnyToolAction = ToolAction<any, any>;
+declare function isToolAction(value: unknown): value is ToolAction;
+/** Adapt a {@link ToolAction} into the AI SDK `tool()` shape. */
+declare function toAISDKTool(toolAction: ToolAction, runtimeContext: RuntimeContext): Tool;
+/**
+ * Build the AI SDK tool map from a record of Redtuma tools and/or raw AI SDK
+ * tools. Redtuma `ToolAction`s are adapted; anything else is passed through.
+ */
+declare function buildToolset(tools: Record<string, AnyToolAction | Tool> | undefined, runtimeContext: RuntimeContext): Record<string, Tool> | undefined;
+//#endregion
+export { AnyToolAction, ToolAction, ToolExecuteContext, buildToolset, createTool, isToolAction, toAISDKTool };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/tools/index.ts"],"sourcesContent":[],"mappings":";;;;;UAIiB;;EAAA,OAAA,EAEN,MAFM;EAEN,cAAA,EACO,cADP;EACO,WAAA,CAAA,EACF,WADE;;AACS,UAGV,UAHU,CAAA,qBAIJ,CAAA,CAAE,UAJE,GAIW,CAAA,CAAE,UAJb,EAAA,sBAKH,CAAA,CAAE,UALC,GAKY,CAAA,CAAE,UALd,CAAA,CAAA;EAGV,EAAA,EAAA,MAAA;EACQ,WAAA,EAAA,MAAA;EAAe,WAAA,EAKzB,YALyB;EACd,YAAA,CAAA,EAKT,aALS;EAAe,OAAA,EAAA,CAAA,GAAA,EAMxB,kBANwB,CAML,CAAA,CAAE,KANG,CAMG,YANH,CAAA,CAAA,EAAA,GAMsB,OANtB,CAAA,OAAA,CAAA,GAAA,OAAA;;;AAMG,iBAI5B,UAJ4B,CAAA,qBAKrB,CAAA,CAAE,UALmB,EAAA,sBAMpB,CAAA,CAAE,UANkB,GAML,CAAA,CAAE,UANG,CAAA,CAAA,MAAA,EAAA;EAAN,EAAA,EAAA,MAAA;EAArB,WAAA,EAAA,MAAA;EAA8C,WAAA,EAUhD,YAVgD;EAAO,YAAA,CAAA,EAWrD,aAXqD;EAItD,OAAA,EAAA,CAAA,GAAU,EAQT,kBARS,CAQU,CAAA,CAAE,KARZ,CAQkB,YARlB,CAAA,CAAA,EAAA,GAQqC,OARrC,CAAA,OAAA,CAAA,GAAA,OAAA;CACH,CAAA,EAQnB,UARqB,CAQV,YARU,EAQI,aARJ,CAAA;;AACgB,KAa7B,aAAA,GAAgB,UAba,CAAA,GAAA,EAAA,GAAA,CAAA;AAI1B,iBAWC,YAAA,CAXD,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IAWwC,UAXxC;;AAE6B,iBAoB5B,WAAA,CApB4B,UAAA,EAqB9B,UArB8B,EAAA,cAAA,EAsB1B,cAtB0B,CAAA,EAuBzC,IAvByC;;;;;AACf,iBAmCb,YAAA,CAnCa,KAAA,EAoCpB,MApCoB,CAAA,MAAA,EAoCL,aApCK,GAoCW,IApCX,CAAA,GAAA,SAAA,EAAA,cAAA,EAqCX,cArCW,CAAA,EAsC1B,MAtC0B,CAAA,MAAA,EAsCX,IAtCW,CAAA,GAAA,SAAA"}

package/dist/tools/index.js

@@ -0,0 +1,36 @@
+import { tool } from "ai";
+
+//#region src/tools/index.ts
+/** Define a Redtuma tool. The id is used as the tool name presented to the model. */
+function createTool(config) {
+	return { ...config };
+}
+function isToolAction(value) {
+	return !!value && typeof value === "object" && typeof value.execute === "function" && "inputSchema" in value && "description" in value;
+}
+/** Adapt a {@link ToolAction} into the AI SDK `tool()` shape. */
+function toAISDKTool(toolAction, runtimeContext) {
+	return tool({
+		description: toolAction.description,
+		parameters: toolAction.inputSchema,
+		execute: async (args, { abortSignal }) => toolAction.execute({
+			context: args,
+			runtimeContext,
+			abortSignal
+		})
+	});
+}
+/**
+* Build the AI SDK tool map from a record of Redtuma tools and/or raw AI SDK
+* tools. Redtuma `ToolAction`s are adapted; anything else is passed through.
+*/
+function buildToolset(tools, runtimeContext) {
+	if (!tools) return void 0;
+	const out = {};
+	for (const [name, t] of Object.entries(tools)) out[name] = isToolAction(t) ? toAISDKTool(t, runtimeContext) : t;
+	return out;
+}
+
+//#endregion
+export { buildToolset, createTool, isToolAction, toAISDKTool };
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["aiTool","out: Record<string, AiTool>"],"sources":["../../src/tools/index.ts"],"sourcesContent":["import { tool as aiTool, type Tool as AiTool } from 'ai'\nimport type { z } from 'zod'\nimport { RuntimeContext } from '../types'\n\nexport interface ToolExecuteContext<TInput> {\n  /** Validated tool input. */\n  context: TInput\n  runtimeContext: RuntimeContext\n  abortSignal?: AbortSignal\n}\n\nexport interface ToolAction<\n  TInputSchema extends z.ZodTypeAny = z.ZodTypeAny,\n  TOutputSchema extends z.ZodTypeAny = z.ZodTypeAny,\n> {\n  id: string\n  description: string\n  inputSchema: TInputSchema\n  outputSchema?: TOutputSchema\n  execute: (ctx: ToolExecuteContext<z.infer<TInputSchema>>) => Promise<unknown> | unknown\n}\n\n/** Define a Redtuma tool. The id is used as the tool name presented to the model. */\nexport function createTool<\n  TInputSchema extends z.ZodTypeAny,\n  TOutputSchema extends z.ZodTypeAny = z.ZodTypeAny,\n>(config: {\n  id: string\n  description: string\n  inputSchema: TInputSchema\n  outputSchema?: TOutputSchema\n  execute: (ctx: ToolExecuteContext<z.infer<TInputSchema>>) => Promise<unknown> | unknown\n}): ToolAction<TInputSchema, TOutputSchema> {\n  return { ...config }\n}\n\n/** A tool with its schema generics erased; use for heterogeneous collections. */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyToolAction = ToolAction<any, any>\n\nexport function isToolAction(value: unknown): value is ToolAction {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    typeof (value as ToolAction).execute === 'function' &&\n    'inputSchema' in value &&\n    'description' in value\n  )\n}\n\n/** Adapt a {@link ToolAction} into the AI SDK `tool()` shape. */\nexport function toAISDKTool(\n  toolAction: ToolAction,\n  runtimeContext: RuntimeContext,\n): AiTool {\n  return aiTool({\n    description: toolAction.description,\n    parameters: toolAction.inputSchema,\n    execute: async (args, { abortSignal }) =>\n      toolAction.execute({ context: args, runtimeContext, abortSignal }),\n  })\n}\n\n/**\n * Build the AI SDK tool map from a record of Redtuma tools and/or raw AI SDK\n * tools. Redtuma `ToolAction`s are adapted; anything else is passed through.\n */\nexport function buildToolset(\n  tools: Record<string, AnyToolAction | AiTool> | undefined,\n  runtimeContext: RuntimeContext,\n): Record<string, AiTool> | undefined {\n  if (!tools) return undefined\n  const out: Record<string, AiTool> = {}\n  for (const [name, t] of Object.entries(tools)) {\n    out[name] = isToolAction(t) ? toAISDKTool(t, runtimeContext) : (t as AiTool)\n  }\n  return out\n}\n"],"mappings":";;;;AAuBA,SAAgB,WAGd,QAM0C;AAC1C,QAAO,EAAE,GAAG,QAAQ;;AAOtB,SAAgB,aAAa,OAAqC;AAChE,QACE,CAAC,CAAC,SACF,OAAO,UAAU,YACjB,OAAQ,MAAqB,YAAY,cACzC,iBAAiB,SACjB,iBAAiB;;;AAKrB,SAAgB,YACd,YACA,gBACQ;AACR,QAAOA,KAAO;EACZ,aAAa,WAAW;EACxB,YAAY,WAAW;EACvB,SAAS,OAAO,MAAM,EAAE,kBACtB,WAAW,QAAQ;GAAE,SAAS;GAAM;GAAgB;GAAa,CAAC;EACrE,CAAC;;;;;;AAOJ,SAAgB,aACd,OACA,gBACoC;AACpC,KAAI,CAAC,MAAO,QAAO;CACnB,MAAMC,MAA8B,EAAE;AACtC,MAAK,MAAM,CAAC,MAAM,MAAM,OAAO,QAAQ,MAAM,CAC3C,KAAI,QAAQ,aAAa,EAAE,GAAG,YAAY,GAAG,eAAe,GAAI;AAElE,QAAO"}

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+import { CoreMessage as CoreMessage$1, LanguageModel } from "ai";
+
+//#region src/types.d.ts
+/** A model is either a `'provider/model'` string or a concrete AI SDK model. */
+type ModelConfig = string | LanguageModel;
+/** A value that may be provided directly or computed from a runtime context. */
+type DynamicArgument<T> = T | ((ctx: {
+  runtimeContext: RuntimeContext;
+}) => T | Promise<T>);
+/** Arbitrary per-invocation key/value context passed through to tools/instructions. */
+declare class RuntimeContext<T extends Record<string, unknown> = Record<string, unknown>> {
+  private readonly map;
+  constructor(initial?: T);
+  get<K extends keyof T & string>(key: K): T[K] | undefined;
+  set<K extends keyof T & string>(key: K, value: T[K]): void;
+  has(key: string): boolean;
+}
+interface Logger {
+  debug(msg: string, meta?: unknown): void;
+  info(msg: string, meta?: unknown): void;
+  warn(msg: string, meta?: unknown): void;
+  error(msg: string, meta?: unknown): void;
+}
+//#endregion
+export { type CoreMessage$1 as CoreMessage, DynamicArgument, Logger, ModelConfig, RuntimeContext };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;KAGY,WAAA,YAAuB;AAAnC;AAGY,KAAA,eAAe,CAAA,CAAA,CAAA,GACvB,CADuB,GAAA,CAAA,CAAA,GAAA,EAAA;EACvB,cAAA,EACyB,cADzB;CACyB,EAAA,GAAqB,CAArB,GAAyB,OAAzB,CAAiC,CAAjC,CAAA,CAAA;;AAAiC,cAGjD,cAHiD,CAAA,UAGxB,MAHwB,CAAA,MAAA,EAAA,OAAA,CAAA,GAGE,MAHF,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA;EAAR,iBAAA,GAAA;EAAO,WAAA,CAAA,OAAA,CAAA,EAMrC,CANqC;EAGhD,GAAA,CAAA,UAAA,MASS,CATK,GAAA,MAAA,CAAA,CAAA,GAAA,EASY,CATZ,CAAA,EASgB,CAThB,CASkB,CATlB,CAAA,GAAA,SAAA;EAAW,GAAA,CAAA,UAAA,MAahB,CAbgB,GAAA,MAAA,CAAA,CAAA,GAAA,EAaC,CAbD,EAAA,KAAA,EAaW,CAbX,CAaa,CAbb,CAAA,CAAA,EAAA,IAAA;EAA0B,GAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;AAS1C,UAaL,MAAA,CAbK;EAAiB,KAAA,CAAA,GAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,OAAA,CAAA,EAAA,IAAA;EAAI,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,OAAA,CAAA,EAAA,IAAA;EAAE,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,OAAA,CAAA,EAAA,IAAA;EAIvB,KAAA,CAAA,GAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,OAAA,CAAA,EAAA,IAAA"}

package/dist/types.js

@@ -0,0 +1,21 @@
+//#region src/types.ts
+/** Arbitrary per-invocation key/value context passed through to tools/instructions. */
+var RuntimeContext = class {
+	map = /* @__PURE__ */ new Map();
+	constructor(initial) {
+		if (initial) for (const [k, v] of Object.entries(initial)) this.map.set(k, v);
+	}
+	get(key) {
+		return this.map.get(key);
+	}
+	set(key, value) {
+		this.map.set(key, value);
+	}
+	has(key) {
+		return this.map.has(key);
+	}
+};
+
+//#endregion
+export { RuntimeContext };
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { CoreMessage, LanguageModel } from 'ai'\n\n/** A model is either a `'provider/model'` string or a concrete AI SDK model. */\nexport type ModelConfig = string | LanguageModel\n\n/** A value that may be provided directly or computed from a runtime context. */\nexport type DynamicArgument<T> =\n  | T\n  | ((ctx: { runtimeContext: RuntimeContext }) => T | Promise<T>)\n\n/** Arbitrary per-invocation key/value context passed through to tools/instructions. */\nexport class RuntimeContext<T extends Record<string, unknown> = Record<string, unknown>> {\n  private readonly map = new Map<string, unknown>()\n\n  constructor(initial?: T) {\n    if (initial) {\n      for (const [k, v] of Object.entries(initial)) this.map.set(k, v)\n    }\n  }\n\n  get<K extends keyof T & string>(key: K): T[K] | undefined {\n    return this.map.get(key) as T[K] | undefined\n  }\n\n  set<K extends keyof T & string>(key: K, value: T[K]): void {\n    this.map.set(key, value)\n  }\n\n  has(key: string): boolean {\n    return this.map.has(key)\n  }\n}\n\nexport interface Logger {\n  debug(msg: string, meta?: unknown): void\n  info(msg: string, meta?: unknown): void\n  warn(msg: string, meta?: unknown): void\n  error(msg: string, meta?: unknown): void\n}\n\n/** Shared dependencies injected into components when registered on a Redtuma instance. */\nexport interface SharedDeps {\n  logger?: Logger\n  storage?: unknown\n  memory?: unknown\n  telemetry?: unknown\n}\n\nexport type { CoreMessage }\n"],"mappings":";;AAWA,IAAa,iBAAb,MAAyF;CACvF,AAAiB,sBAAM,IAAI,KAAsB;CAEjD,YAAY,SAAa;AACvB,MAAI,QACF,MAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,QAAQ,CAAE,MAAK,IAAI,IAAI,GAAG,EAAE;;CAIpE,IAAgC,KAA0B;AACxD,SAAO,KAAK,IAAI,IAAI,IAAI;;CAG1B,IAAgC,KAAQ,OAAmB;AACzD,OAAK,IAAI,IAAI,KAAK,MAAM;;CAG1B,IAAI,KAAsB;AACxB,SAAO,KAAK,IAAI,IAAI,IAAI"}

package/dist/workflows/index.d.ts

@@ -0,0 +1,114 @@
+import { Logger, RuntimeContext } from "../types.js";
+import { z } from "zod";
+
+//#region src/workflows/index.d.ts
+interface StepExecuteContext<TInput = unknown, TResume = unknown> {
+  inputData: TInput;
+  runtimeContext: RuntimeContext;
+  /** Result of a previously completed step by id. */
+  getStepResult: (stepId: string) => unknown;
+  /** Data passed to `run.resume()` when resuming a suspended step. */
+  resumeData?: TResume;
+  /** Suspend the workflow for human-in-the-loop; throws to halt execution. */
+  suspend: (payload?: unknown) => never;
+}
+interface Step<TInputSchema extends z.ZodTypeAny = z.ZodTypeAny, TOutputSchema extends z.ZodTypeAny = z.ZodTypeAny> {
+  id: string;
+  inputSchema?: TInputSchema;
+  outputSchema?: TOutputSchema;
+  resumeSchema?: z.ZodTypeAny;
+  suspendSchema?: z.ZodTypeAny;
+  execute: (ctx: StepExecuteContext) => Promise<unknown> | unknown;
+}
+declare function createStep<TInputSchema extends z.ZodTypeAny = z.ZodTypeAny, TOutputSchema extends z.ZodTypeAny = z.ZodTypeAny>(config: {
+  id: string;
+  inputSchema?: TInputSchema;
+  outputSchema?: TOutputSchema;
+  resumeSchema?: z.ZodTypeAny;
+  suspendSchema?: z.ZodTypeAny;
+  execute: (ctx: StepExecuteContext) => Promise<unknown> | unknown;
+}): Step<TInputSchema, TOutputSchema>;
+type Condition = (args: {
+  inputData: unknown;
+  runtimeContext: RuntimeContext;
+}) => boolean | Promise<boolean>;
+type Node = {
+  kind: 'step';
+  step: Step;
+} | {
+  kind: 'parallel';
+  steps: Step[];
+} | {
+  kind: 'branch';
+  branches: [Condition, Step][];
+} | {
+  kind: 'dountil';
+  step: Step;
+  condition: Condition;
+} | {
+  kind: 'foreach';
+  step: Step;
+} | {
+  kind: 'map';
+  fn: (input: unknown) => unknown;
+};
+type RunStatus = 'success' | 'suspended' | 'failed';
+interface RunResult {
+  status: RunStatus;
+  result?: unknown;
+  error?: Error;
+  suspended?: {
+    stepId: string;
+    payload: unknown;
+  };
+  steps: Record<string, unknown>;
+}
+declare class Workflow {
+  config: {
+    id: string;
+    inputSchema?: z.ZodTypeAny;
+    outputSchema?: z.ZodTypeAny;
+  };
+  readonly id: string;
+  private nodes;
+  private committed;
+  logger: Logger;
+  constructor(config: {
+    id: string;
+    inputSchema?: z.ZodTypeAny;
+    outputSchema?: z.ZodTypeAny;
+  });
+  then(step: Step): this;
+  parallel(steps: Step[]): this;
+  branch(branches: [Condition, Step][]): this;
+  dountil(step: Step, condition: Condition): this;
+  foreach(step: Step): this;
+  map(fn: (input: unknown) => unknown): this;
+  commit(): this;
+  createRun(): Run;
+}
+declare class Run {
+  readonly workflowId: string;
+  private readonly nodes;
+  private snapshot;
+  constructor(workflowId: string, nodes: Node[]);
+  start(args: {
+    inputData: unknown;
+    runtimeContext?: RuntimeContext;
+  }): Promise<RunResult>;
+  resume(args: {
+    step: string;
+    resumeData?: unknown;
+    runtimeContext?: RuntimeContext;
+  }): Promise<RunResult>;
+  private execute;
+  private runStep;
+}
+declare function createWorkflow(config: {
+  id: string;
+  inputSchema?: z.ZodTypeAny;
+  outputSchema?: z.ZodTypeAny;
+}): Workflow;
+//#endregion
+export { Run, RunResult, RunStatus, Step, StepExecuteContext, Workflow, createStep, createWorkflow };
+//# sourceMappingURL=index.d.ts.map

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

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