@orkestrel/agent 0.0.43 → 0.0.45

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

@@ -3382,8 +3382,8 @@ export declare function collectBuiltinDefinitions(options: Pick<AgentOptions, 'b
  * {@link findToolCall}. It then folds the pairs in message order: a `load` whose message content
  * equals `BUILTIN_NOTES.loaded` adds its `skill`, an `unload` with `BUILTIN_NOTES.unloaded` removes
  * it, and a `switch` with `BUILTIN_NOTES.switched` selects its `workspace`. Each call's arguments
- * are admitted through the built-in's contract in `builtinToolContracts`, lossless repairs
- * included, as its tool's door admits them, so a `{ skill: 1 }` the door repaired to `'1'` counts
+ * are repaired through the built-in's contract in `builtinToolContracts` by `repairValue`, as
+ * its tool's door repairs them, so a `{ skill: 1 }` the door repaired to `'1'` counts
  * as `'1'`; arguments the contract refuses change nothing. A skill loaded again while shown keeps
  * its place, and one loaded again after its unload goes last. Any other message and a denied or
  * refused call change nothing. The result holds `workspace` only when a switch succeeded.

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

@@ -3382,8 +3382,8 @@ export declare function collectBuiltinDefinitions(options: Pick<AgentOptions, 'b
  * {@link findToolCall}. It then folds the pairs in message order: a `load` whose message content
  * equals `BUILTIN_NOTES.loaded` adds its `skill`, an `unload` with `BUILTIN_NOTES.unloaded` removes
  * it, and a `switch` with `BUILTIN_NOTES.switched` selects its `workspace`. Each call's arguments
- * are admitted through the built-in's contract in `builtinToolContracts`, lossless repairs
- * included, as its tool's door admits them, so a `{ skill: 1 }` the door repaired to `'1'` counts
+ * are repaired through the built-in's contract in `builtinToolContracts` by `repairValue`, as
+ * its tool's door repairs them, so a `{ skill: 1 }` the door repaired to `'1'` counts
  * as `'1'`; arguments the contract refuses change nothing. A skill loaded again while shown keeps
  * its place, and one loaded again after its unload goes last. Any other message and a denied or
  * refused call change nothing. The result holds `workspace` only when a switch succeeded.

package/dist/src/core/index.js

@@ -1,4 +1,4 @@
-import { ContractError, INTRINSICS, admitValue, arrayOf, arrayShape, attempt, booleanShape, boundsOf, canonicalStringify, cloneJSONValue, createContract, describeFaults, errorToMessage, failure, holds, integerShape, isArray, isBoolean, isError, isFiniteNumber, isFunction, isJSONValue, isNumber, isObject, isPromiseLike, isRecord, isString, jsonShape, literalOf, literalShape, matchesExactKeys, nullableOf, nullableShape, numberShape, objectOf, objectShape, optionalOf, optionalShape, parseJSON, parseJSONAs, parseJSONValue, preview, rawShape, recordOf, recordShape, refuseOptionKeys, schemaToParameters, schemaToShape, stringShape, success, unionOf, unionShape } from "@orkestrel/contract";
+import { ContractError, INTRINSICS, arrayOf, arrayShape, attempt, booleanShape, boundsOf, canonicalStringify, cloneJSONValue, createContract, describeFaults, errorToMessage, failure, holds, integerShape, isArray, isBoolean, isError, isFiniteNumber, isFunction, isJSONValue, isNumber, isObject, isPromiseLike, isRecord, isString, jsonShape, literalOf, literalShape, matchesExactKeys, nullableOf, nullableShape, numberShape, objectOf, objectShape, optionalOf, optionalShape, parseJSON, parseJSONAs, parseJSONValue, preview, rawShape, recordOf, recordShape, refuseOptionKeys, repairValue, schemaToParameters, schemaToShape, stringShape, success, unionOf, unionShape } from "@orkestrel/contract";
 import { createTokenBudget, createTokenMeter, isBudget, isBudgetAmount, isBudgetError, isTokenUsage } from "@orkestrel/budget";
 import { ToolError, ToolManager, createTool, createToolManager, isToolCall, isToolError } from "@orkestrel/tool";
 import { createNDJSONParser } from "@orkestrel/ndjson";
@@ -6701,20 +6701,20 @@ var BUILTIN_LIMITS = Object.freeze({
 * definitions `collectBuiltinDefinitions` returns both read their text and annotations here.
 */
 var BUILTIN_TOOLS = Object.freeze({
-	load: Object.freeze({ description: "Loads one skill from the skills index, so its instructions join yours and its tools become callable from your next step. Example: {\"skill\":\"refunds\"}. Replies with a short acknowledgement, not the instructions; call unload when you no longer need the skill." }),
-	unload: Object.freeze({ description: "Unloads one skill you loaded, so its instructions and tools leave from your next step. Example: {\"skill\":\"refunds\"}. Replies with a short acknowledgement." }),
+	load: Object.freeze({ description: "Loads one skill from the skills index, so its instructions join yours and its tools become callable from your next step. Example: {\"skill\":\"refunds\"}. A number given as the skill reads as its digits, so {\"skill\":7} loads the skill \"7\". Replies with a short acknowledgement, not the instructions; call unload when you no longer need the skill." }),
+	unload: Object.freeze({ description: "Unloads one skill you loaded, so its instructions and tools leave from your next step. Example: {\"skill\":\"refunds\"}. A number given as the skill reads as its digits, so {\"skill\":7} unloads the skill \"7\". Replies with a short acknowledgement." }),
 	memo: Object.freeze({
-		description: "Reads one memo from the memos index and replies with its full text. Example: {\"name\":\"tone\"}. Reading changes nothing; call remember to write a memo.",
+		description: "Reads one memo from the memos index and replies with its full text. Example: {\"name\":\"tone\"}. A number given as the name reads as its digits, so {\"name\":7} reads the memo \"7\". Reading changes nothing; call remember to write a memo.",
 		annotations: Object.freeze({
 			pure: true,
 			untrusted: true
 		})
 	}),
 	remember: Object.freeze({
-		description: "Saves one memo under a name you are allowed to write: a one-line description for the memos index, and the content. Example: {\"name\":\"tone\",\"description\":\"Reply tone\",\"content\":\"Keep replies brief, because the user asked for that.\"}. Replies with a short acknowledgement; call memo to read a memo back.",
+		description: "Saves one memo under a name you are allowed to write: a one-line description for the memos index, and the content. Example: {\"name\":\"tone\",\"description\":\"Reply tone\",\"content\":\"Keep replies brief, because the user asked for that.\"}. A number given for any of the three reads as its digits, so a name of 7 saves the memo \"7\". Replies with a short acknowledgement; call memo to read a memo back.",
 		annotations: Object.freeze({ consequential: true })
 	}),
-	switch: Object.freeze({ description: "Selects one workspace from the workspaces index, so its files join your context from your next step. Example: {\"workspace\":\"orders\"}. Replies with a short acknowledgement." })
+	switch: Object.freeze({ description: "Selects one workspace from the workspaces index, so its files join your context from your next step. Example: {\"workspace\":\"orders\"}. A number given as the workspace reads as its digits, so {\"workspace\":7} selects the workspace \"7\". Replies with a short acknowledgement." })
 });
 /**
 * Matches one control, format, line-separator, or paragraph-separator code point — the class
@@ -8604,8 +8604,8 @@ function resolveDisclosure(context, conversation, workspace, ceiling, builtins)
 * {@link findToolCall}. It then folds the pairs in message order: a `load` whose message content
 * equals `BUILTIN_NOTES.loaded` adds its `skill`, an `unload` with `BUILTIN_NOTES.unloaded` removes
 * it, and a `switch` with `BUILTIN_NOTES.switched` selects its `workspace`. Each call's arguments
-* are admitted through the built-in's contract in `builtinToolContracts`, lossless repairs
-* included, as its tool's door admits them, so a `{ skill: 1 }` the door repaired to `'1'` counts
+* are repaired through the built-in's contract in `builtinToolContracts` by `repairValue`, as
+* its tool's door repairs them, so a `{ skill: 1 }` the door repaired to `'1'` counts
 * as `'1'`; arguments the contract refuses change nothing. A skill loaded again while shown keeps
 * its place, and one loaded again after its unload goes last. Any other message and a denied or
 * refused call change nothing. The result holds `workspace` only when a switch succeeded.
@@ -8641,9 +8641,9 @@ function collectDisclosure(conversation, builtins) {
 		if (call === void 0 || !isAgentBuiltin(name) || !counted.has(name)) return shown;
 		const note = name === "load" ? BUILTIN_NOTES.loaded : name === "unload" ? BUILTIN_NOTES.unloaded : BUILTIN_NOTES.switched;
 		if (message.content !== note) return shown;
-		const admitted = admitValue(builtinToolContracts[name].contract, { ...call.arguments });
-		const skill = admitted.success ? admitted.value.value["skill"] : void 0;
-		const workspace = admitted.success ? admitted.value.value["workspace"] : void 0;
+		const repaired = repairValue(builtinToolContracts[name].contract, { ...call.arguments });
+		const skill = repaired.success ? repaired.value.value["skill"] : void 0;
+		const workspace = repaired.success ? repaired.value.value["workspace"] : void 0;
 		if (name === "load") return !isString(skill) || shown.skills.includes(skill) ? shown : {
 			...shown,
 			skills: [...shown.skills, skill]
@@ -13477,7 +13477,7 @@ var Ledger = class {
 		}));
 		tools.add(createTool({
 			name: "recall",
-			description: `Find something said earlier that isn't in the messages you can see, by an owner name, an id, or one of the topics ${renderTopicNames(options.topics)}. Returns statements and lookup findings first, then earlier requests and replies labeled by origin; newest first within each group.`,
+			description: `Find something said earlier that isn't in the messages you can see, by an owner name, an id, or one of the topics ${renderTopicNames(options.topics)}. A number given as the topic reads as its digits, so {"topic":7} searches for "7". Returns statements and lookup findings first, then earlier requests and replies labeled by origin; newest first within each group.`,
 			contract: objectShape({ topic: stringShape({
 				min: 1,
 				description: "An owner name, an id, or a topic"
@@ -13879,8 +13879,8 @@ var Ledger = class {
 		const gauge = this.#gauge;
 		if (gauge === void 0) return void 0;
 		const room = gauge.remainder(request.calls) - this.#predict;
-		const admitted = admitValue(builtinToolContracts[name].contract, { ...args });
-		const values = admitted.success ? admitted.value.value : {};
+		const repaired = repairValue(builtinToolContracts[name].contract, { ...args });
+		const values = repaired.success ? repaired.value.value : {};
 		if (name === "remember") {
 			const line = isString(values["name"]) && isString(values["description"]) ? renderIndexEntry({
 				name: values["name"],