@orkestrel/toolbox 0.0.14 → 0.0.15

package/dist/src/core/index.d.cts

@@ -10,6 +10,7 @@ import type { ConversationStoreInterface } from '@orkestrel/agent';
 import type { DatabaseErrorCode } from '@orkestrel/database';
 import type { DatabaseInterface } from '@orkestrel/database';
 import type { DriverInterface } from '@orkestrel/database';
+import type { Guard } from '@orkestrel/contract';
 import type { Include } from '@orkestrel/relation';
 import type { IndexMap } from '@orkestrel/database';
 import { JSONShape } from '@orkestrel/contract';
@@ -1800,7 +1801,7 @@ export declare function isAgentFunction(value: unknown): value is AgentFunction;
  * @param value - The value to inspect
  * @returns True if `value` is `'string'`, `'integer'`, `'number'`, or `'boolean'`; false otherwise
  */
-export declare function isColumnPrimitive(value: unknown): value is ColumnPrimitive;
+export declare const isColumnPrimitive: Guard<ColumnPrimitive>;
 
 /**
  * Narrows an unknown value to a {@link ColumnSpec}.

package/dist/src/core/index.d.ts

@@ -10,6 +10,7 @@ import type { ConversationStoreInterface } from '@orkestrel/agent';
 import type { DatabaseErrorCode } from '@orkestrel/database';
 import type { DatabaseInterface } from '@orkestrel/database';
 import type { DriverInterface } from '@orkestrel/database';
+import type { Guard } from '@orkestrel/contract';
 import type { Include } from '@orkestrel/relation';
 import type { IndexMap } from '@orkestrel/database';
 import { JSONShape } from '@orkestrel/contract';
@@ -1800,7 +1801,7 @@ export declare function isAgentFunction(value: unknown): value is AgentFunction;
  * @param value - The value to inspect
  * @returns True if `value` is `'string'`, `'integer'`, `'number'`, or `'boolean'`; false otherwise
  */
-export declare function isColumnPrimitive(value: unknown): value is ColumnPrimitive;
+export declare const isColumnPrimitive: Guard<ColumnPrimitive>;
 
 /**
  * Narrows an unknown value to a {@link ColumnSpec}.

package/dist/src/core/index.js

@@ -1,4 +1,4 @@
-import { arrayShape, attempt, booleanShape, cloneJSONRecord, createContract, integerShape, isFiniteNumber, isNonEmptyString, isRecord, isString, jsonShape, literalShape, numberShape, objectShape, optionalShape, parseJSONValue, rawShape, recordShape, samplesToSchema, schemaToObject, schemaToParameters, schemaToShape, stringShape, unionShape } from "@orkestrel/contract";
+import { arrayShape, attempt, booleanShape, cloneJSONRecord, createContract, integerShape, isArray, isBoolean, isError, isFiniteNumber, isFunction, isInstance, isNonEmptyString, isNumber, isObject, isRecord, isString, jsonShape, literalOf, literalShape, numberShape, objectShape, optionalShape, parseJSONValue, rawShape, recordShape, samplesToSchema, schemaToObject, schemaToParameters, schemaToShape, stringShape, unionShape } from "@orkestrel/contract";
 import { MAX_TIMER_MS, createWorkflowContract } from "@orkestrel/workflow";
 import { isTerminalError } from "@orkestrel/terminal";
 import { createDatabase, createMemoryDriver, isDatabaseError } from "@orkestrel/database";
@@ -632,7 +632,7 @@ var ToolboxError = class extends Error {
 * ```
 */
 function isToolboxError(value) {
-	return value instanceof ToolboxError;
+	return isInstance(value, ToolboxError);
 }
 //#endregion
 //#region src/core/validators.ts
@@ -644,7 +644,7 @@ function isToolboxError(value) {
 */
 function isWorkflowLineage(value) {
 	const inspected = attempt(() => {
-		if (!Array.isArray(value)) return false;
+		if (!isArray(value)) return false;
 		const seen = /* @__PURE__ */ new Set();
 		for (const [index, tag] of value.entries()) {
 			if (!isString(tag)) return false;
@@ -664,7 +664,7 @@ function isWorkflowLineage(value) {
 */
 function isAgentFunction(value) {
 	const inspected = attempt(() => {
-		if (typeof value !== "function" || !Object.isFrozen(value)) return false;
+		if (!isFunction(value) || !Object.isFrozen(value)) return false;
 		const category = Reflect.getOwnPropertyDescriptor(value, "category");
 		const lineage = Reflect.getOwnPropertyDescriptor(value, "lineage");
 		return category?.value === "agent" && lineage !== void 0 && "value" in lineage && Object.isFrozen(lineage.value) && isWorkflowLineage(lineage.value);
@@ -680,7 +680,7 @@ function isAgentFunction(value) {
 function isColumnSpec(value) {
 	if (isColumnPrimitive(value)) return true;
 	if (!isRecord(value)) return false;
-	return isColumnPrimitive(value.primitive) && (value.optional === void 0 || typeof value.optional === "boolean");
+	return isColumnPrimitive(value.primitive) && (value.optional === void 0 || isBoolean(value.optional));
 }
 /**
 * Narrows an unknown value to a {@link ColumnPrimitive}.
@@ -688,9 +688,7 @@ function isColumnSpec(value) {
 * @param value - The value to inspect
 * @returns True if `value` is `'string'`, `'integer'`, `'number'`, or `'boolean'`; false otherwise
 */
-function isColumnPrimitive(value) {
-	return value === "string" || value === "integer" || value === "number" || value === "boolean";
-}
+var isColumnPrimitive = literalOf("string", "integer", "number", "boolean");
 /**
 * Narrows an unknown value to a {@link DatabaseDefinition} — a non-empty `id` and `driver`, a
 * `tables` record whose every value is `{ columns: record of valid ColumnSpec }`, plus optional
@@ -717,9 +715,9 @@ function isDatabaseDefinition(value) {
 	if (value.indexes !== void 0) {
 		if (!isRecord(value.indexes)) return false;
 		for (const groups of Object.values(value.indexes)) {
-			if (!Array.isArray(groups)) return false;
+			if (!isArray(groups)) return false;
 			for (const group of groups) {
-				if (!Array.isArray(group) || group.length === 0) return false;
+				if (!isArray(group) || group.length === 0) return false;
 				for (const column of group) if (!isNonEmptyString(column)) return false;
 			}
 		}
@@ -1575,7 +1573,7 @@ function expandInclude(paths, depth) {
 			});
 			ancestors.push(branch);
 			const existing = branch[segment];
-			branch = typeof existing === "object" ? existing : {};
+			branch = isObject(existing) ? existing : {};
 		}
 		const leaf = segments[last];
 		if (leaf === void 0) throw new ToolboxError("TOOL", `malformed include path '${path}'`, {
@@ -2210,7 +2208,7 @@ function createWorkflowFunctions(runner, options) {
 	const composed = {};
 	Object.setPrototypeOf(composed, null);
 	for (const [name, fn] of Object.entries(functions)) {
-		if (typeof fn !== "function") throw new ToolboxError("TOOL", `workflow function '${name}' is not callable`, { function: name });
+		if (!isFunction(fn)) throw new ToolboxError("TOOL", `workflow function '${name}' is not callable`, { function: name });
 		if (isAgentFunction(fn)) throw new ToolboxError("TOOL", `agent function '${name}' must be supplied through agents`, { function: name });
 		composed[name] = fn;
 	}
@@ -2339,7 +2337,7 @@ function createWorkflowTool(definition, runner, options) {
 			const owned = cloned.value;
 			let target;
 			if (Object.keys(owned).length === 0) target = definition;
-			else if (Array.isArray(owned.steps)) {
+			else if (isArray(owned.steps)) {
 				const flat = steps.parse(owned);
 				target = flat === void 0 ? void 0 : expandSteps(flat);
 			} else {
@@ -2898,7 +2896,7 @@ function createDatabaseDefinitionStore(driver = createMemoryDriver()) {
 * ```
 */
 function createDatabaseTool(options = {}) {
-	if (options.timeout !== void 0 && (options.timeout < 0 || !Number.isSafeInteger(options.timeout))) throw new ToolboxError("TOOL", "database timeout must be a nonnegative safe integer", { timeout: options.timeout });
+	if (options.timeout !== void 0 && (options.timeout < 0 || !isNumber(options.timeout) || !Number.isSafeInteger(options.timeout))) throw new ToolboxError("TOOL", "database timeout must be a nonnegative safe integer", { timeout: options.timeout });
 	const contract = createContract(databaseToolShape);
 	const parameters = schemaToParameters(contract.schema);
 	const handles = new Map(Object.entries(options.databases ?? {}));
@@ -2968,8 +2966,8 @@ function createDatabaseTool(options = {}) {
 					}
 					case "get": {
 						const table = (await resolver.resolve(call.id)).table(call.table);
-						const many = Array.isArray(call.key);
-						const keys = Array.isArray(call.key) ? call.key : [call.key];
+						const many = isArray(call.key);
+						const keys = isArray(call.key) ? call.key : [call.key];
 						const rows = await table.get(keys);
 						return many ? { rows } : { row: rows[0] };
 					}
@@ -2990,30 +2988,30 @@ function createDatabaseTool(options = {}) {
 					case "aggregate": return { value: await (await resolver.resolve(call.id)).table(call.table).aggregate(call.function, call.column, normalizeQuery(call.query), read) };
 					case "add": {
 						const table = (await resolver.resolve(call.id)).table(call.table);
-						const many = Array.isArray(call.row);
-						const rows = Array.isArray(call.row) ? call.row : [call.row];
+						const many = isArray(call.row);
+						const rows = isArray(call.row) ? call.row : [call.row];
 						const keys = await table.add(rows, read);
 						return many ? { keys } : { key: keys[0] };
 					}
 					case "set": {
 						const table = (await resolver.resolve(call.id)).table(call.table);
-						const many = Array.isArray(call.row);
-						const rows = Array.isArray(call.row) ? call.row : [call.row];
+						const many = isArray(call.row);
+						const rows = isArray(call.row) ? call.row : [call.row];
 						const keys = await table.set(rows, read);
 						return many ? { keys } : { key: keys[0] };
 					}
 					case "update": {
 						const table = (await resolver.resolve(call.id)).table(call.table);
 						const changes = call.changes;
-						const many = Array.isArray(call.key);
-						const keys = Array.isArray(call.key) ? call.key : [call.key];
+						const many = isArray(call.key);
+						const keys = isArray(call.key) ? call.key : [call.key];
 						const updated = await table.update(keys, changes, read);
 						return many ? { updated } : { updated: updated[0] };
 					}
 					case "remove": {
 						const table = (await resolver.resolve(call.id)).table(call.table);
-						const many = Array.isArray(call.key);
-						const keys = Array.isArray(call.key) ? call.key : [call.key];
+						const many = isArray(call.key);
+						const keys = isArray(call.key) ? call.key : [call.key];
 						const removed = await table.remove(keys, read);
 						return many ? { removed } : { removed: removed[0] };
 					}
@@ -3035,7 +3033,7 @@ function createDatabaseTool(options = {}) {
 				if (isToolboxError(error)) throw error;
 				const code = inferDatabaseCode(error);
 				if (code === void 0) throw error;
-				throw new ToolboxError("DATABASE", error instanceof Error ? error.message : String(error), {
+				throw new ToolboxError("DATABASE", isError(error) ? error.message : String(error), {
 					code,
 					operation: call.operation,
 					id: call.id,
@@ -3114,7 +3112,7 @@ function createRelationTool(options) {
 				switch (call.operation) {
 					case "load": {
 						const include = expandInclude(call.include, depth);
-						if (typeof call.key === "string" || typeof call.key === "number") return { row: await model.load(call.key, include) };
+						if (isString(call.key) || isNumber(call.key)) return { row: await model.load(call.key, include) };
 						return { rows: await model.load(call.key, include) };
 					}
 					case "find": {
@@ -3157,7 +3155,7 @@ function createRelationTool(options) {
 			} catch (error) {
 				if (isToolboxError(error)) throw error;
 				const relation = inferRelationCode(error);
-				if (relation !== void 0) throw new ToolboxError("RELATION", error instanceof Error ? error.message : String(error), {
+				if (relation !== void 0) throw new ToolboxError("RELATION", isError(error) ? error.message : String(error), {
 					code: relation,
 					operation: call.operation,
 					model: call.model,
@@ -3165,7 +3163,7 @@ function createRelationTool(options) {
 				});
 				const database = inferDatabaseCode(error);
 				if (database === void 0) throw error;
-				throw new ToolboxError("DATABASE", error instanceof Error ? error.message : String(error), {
+				throw new ToolboxError("DATABASE", isError(error) ? error.message : String(error), {
 					code: database,
 					operation: call.operation
 				});