@ai-ecoverse/slicc-agent 5.5.2 → 5.5.4

package/dist/selection.js

@@ -0,0 +1,74 @@
+import {
+  AgentDoc,
+  defineDoc
+} from "@earendil-works/pi-durable";
+const SELECTION = ["extensions", "tools", "modelTools", "instructions"];
+const ALL = ["model", "thinkingLevel", "cwd", ...SELECTION];
+const SelectionDoc = defineDoc({
+  kind: "slicc.selection",
+  version: 1,
+  scope: "session",
+  initial: () => ({ version: 0 })
+});
+const SELECTION_VERSION = 1;
+async function storedAgent(harness, conversationId, context) {
+  return structuredClone(await harness.snapshot(AgentDoc, conversationId, context) ?? {});
+}
+function copyAgent(from, fields = ALL) {
+  return async (tx, conversationId) => {
+    const agent = await tx.doc(AgentDoc, conversationId);
+    for (const field of fields) {
+      const value = from[field];
+      if (value === void 0) delete agent[field];
+      else agent[field] = structuredClone(value);
+    }
+  };
+}
+function unfrozen(agent, choosable) {
+  let changed = false;
+  if (Array.isArray(agent.extensions)) {
+    delete agent.extensions;
+    changed = true;
+  }
+  if (Array.isArray(agent.tools) && !agent.tools.every(choosable)) {
+    delete agent.tools;
+    changed = true;
+  }
+  return changed;
+}
+function unfreezeCreated(choosable) {
+  return async (tx, conversation) => {
+    unfrozen(await tx.doc(AgentDoc, conversation.id), choosable);
+  };
+}
+async function unfreeze(harness, storage, choosable, context) {
+  const done = await harness.snapshot(SelectionDoc, context);
+  if ((done?.version ?? 0) >= SELECTION_VERSION) return 0;
+  let fixed = 0;
+  let cursor;
+  do {
+    const page = await storage.scanConversations({}, 100, cursor, context);
+    for (const record of page.items)
+      if (await harness.commit(
+        async (tx) => unfrozen(await tx.doc(AgentDoc, record.id), choosable),
+        context
+      ))
+        fixed++;
+    cursor = page.next;
+  } while (cursor);
+  await harness.commit(async (tx) => {
+    (await tx.doc(SelectionDoc)).version = SELECTION_VERSION;
+  }, context);
+  return fixed;
+}
+export {
+  SELECTION,
+  SELECTION_VERSION,
+  SelectionDoc,
+  copyAgent,
+  storedAgent,
+  unfreeze,
+  unfreezeCreated,
+  unfrozen
+};
+//# sourceMappingURL=selection.js.map

package/dist/selection.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/selection.ts"],
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport {\n  AgentDoc,\n  type AgentState,\n  type ConversationId,\n  type ConversationInit,\n  type Cursor,\n  defineDoc,\n  type Harness,\n  type HarnessOptions,\n  type Storage,\n} from '@earendil-works/pi-durable';\n\nexport type Choosable = (tool: string) => boolean;\n\ntype Field = keyof AgentState;\n\nexport const SELECTION: readonly Field[] = ['extensions', 'tools', 'modelTools', 'instructions'];\n\nconst ALL: readonly Field[] = ['model', 'thinkingLevel', 'cwd', ...SELECTION];\n\nexport const SelectionDoc = defineDoc<{ version: number }>({\n  kind: 'slicc.selection',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ version: 0 }),\n});\n\nexport const SELECTION_VERSION = 1;\n\nexport async function storedAgent(\n  harness: Pick<Harness, 'snapshot'>,\n  conversationId: ConversationId,\n  context: Context\n): Promise<AgentState> {\n  return structuredClone((await harness.snapshot(AgentDoc, conversationId, context)) ?? {});\n}\n\nexport function copyAgent(from: AgentState, fields: readonly Field[] = ALL): ConversationInit {\n  return async (tx, conversationId) => {\n    const agent = (await tx.doc(AgentDoc, conversationId)) as Record<string, unknown>;\n    for (const field of fields) {\n      const value = from[field];\n      if (value === undefined) delete agent[field];\n      else agent[field] = structuredClone(value);\n    }\n  };\n}\n\nexport function unfrozen(agent: AgentState, choosable: Choosable): boolean {\n  let changed = false;\n  if (Array.isArray(agent.extensions)) {\n    delete agent.extensions;\n    changed = true;\n  }\n  if (Array.isArray(agent.tools) && !agent.tools.every(choosable)) {\n    delete agent.tools;\n    changed = true;\n  }\n  return changed;\n}\n\nexport function unfreezeCreated(choosable: Choosable): HarnessOptions['conversationCreated'] {\n  return async (tx, conversation) => {\n    unfrozen(await tx.doc(AgentDoc, conversation.id), choosable);\n  };\n}\n\nexport async function unfreeze(\n  harness: Pick<Harness, 'snapshot' | 'commit'>,\n  storage: Pick<Storage, 'scanConversations'>,\n  choosable: Choosable,\n  context: Context\n): Promise<number> {\n  const done = await harness.snapshot(SelectionDoc, context);\n  if ((done?.version ?? 0) >= SELECTION_VERSION) return 0;\n  let fixed = 0;\n  let cursor: Cursor | undefined;\n  do {\n    const page = await storage.scanConversations({}, 100, cursor, context);\n    for (const record of page.items)\n      if (\n        await harness.commit(\n          async (tx) => unfrozen(await tx.doc(AgentDoc, record.id), choosable),\n          context\n        )\n      )\n        fixed++;\n    cursor = page.next;\n  } while (cursor);\n  await harness.commit(async (tx) => {\n    (await tx.doc(SelectionDoc)).version = SELECTION_VERSION;\n  }, context);\n  return fixed;\n}\n"],
+  "mappings": "AACA;AAAA,EACE;AAAA,EAKA;AAAA,OAIK;AAMA,MAAM,YAA8B,CAAC,cAAc,SAAS,cAAc,cAAc;AAE/F,MAAM,MAAwB,CAAC,SAAS,iBAAiB,OAAO,GAAG,SAAS;AAErE,MAAM,eAAe,UAA+B;AAAA,EACzD,MAAM;AAAA,EACN,SAAS;AAAA,EACT,OAAO;AAAA,EACP,SAAS,OAAO,EAAE,SAAS,EAAE;AAC/B,CAAC;AAEM,MAAM,oBAAoB;AAEjC,eAAsB,YACpB,SACA,gBACA,SACqB;AACrB,SAAO,gBAAiB,MAAM,QAAQ,SAAS,UAAU,gBAAgB,OAAO,KAAM,CAAC,CAAC;AAC1F;AAEO,SAAS,UAAU,MAAkB,SAA2B,KAAuB;AAC5F,SAAO,OAAO,IAAI,mBAAmB;AACnC,UAAM,QAAS,MAAM,GAAG,IAAI,UAAU,cAAc;AACpD,eAAW,SAAS,QAAQ;AAC1B,YAAM,QAAQ,KAAK,KAAK;AACxB,UAAI,UAAU,OAAW,QAAO,MAAM,KAAK;AAAA,UACtC,OAAM,KAAK,IAAI,gBAAgB,KAAK;AAAA,IAC3C;AAAA,EACF;AACF;AAEO,SAAS,SAAS,OAAmB,WAA+B;AACzE,MAAI,UAAU;AACd,MAAI,MAAM,QAAQ,MAAM,UAAU,GAAG;AACnC,WAAO,MAAM;AACb,cAAU;AAAA,EACZ;AACA,MAAI,MAAM,QAAQ,MAAM,KAAK,KAAK,CAAC,MAAM,MAAM,MAAM,SAAS,GAAG;AAC/D,WAAO,MAAM;AACb,cAAU;AAAA,EACZ;AACA,SAAO;AACT;AAEO,SAAS,gBAAgB,WAA6D;AAC3F,SAAO,OAAO,IAAI,iBAAiB;AACjC,aAAS,MAAM,GAAG,IAAI,UAAU,aAAa,EAAE,GAAG,SAAS;AAAA,EAC7D;AACF;AAEA,eAAsB,SACpB,SACA,SACA,WACA,SACiB;AACjB,QAAM,OAAO,MAAM,QAAQ,SAAS,cAAc,OAAO;AACzD,OAAK,MAAM,WAAW,MAAM,kBAAmB,QAAO;AACtD,MAAI,QAAQ;AACZ,MAAI;AACJ,KAAG;AACD,UAAM,OAAO,MAAM,QAAQ,kBAAkB,CAAC,GAAG,KAAK,QAAQ,OAAO;AACrE,eAAW,UAAU,KAAK;AACxB,UACE,MAAM,QAAQ;AAAA,QACZ,OAAO,OAAO,SAAS,MAAM,GAAG,IAAI,UAAU,OAAO,EAAE,GAAG,SAAS;AAAA,QACnE;AAAA,MACF;AAEA;AACJ,aAAS,KAAK;AAAA,EAChB,SAAS;AACT,QAAM,QAAQ,OAAO,OAAO,OAAO;AACjC,KAAC,MAAM,GAAG,IAAI,YAAY,GAAG,UAAU;AAAA,EACzC,GAAG,OAAO;AACV,SAAO;AACT;",
+  "names": []
+}

package/dist/types/agent.d.ts

@@ -10,6 +10,7 @@ export interface AgentOptions {
     registry?: Registry;
     settings?: HarnessOptions['settings'];
     env?: HarnessOptions['env'];
+    conversationCreated?: HarnessOptions['conversationCreated'];
     context?: Context;
     beforeResume?: (harness: Harness, context: Context) => Promise<unknown>;
 }

package/dist/types/browser/guard.d.ts

@@ -1,4 +1,4 @@
-import { type Extension, type ToolRegistration } from '@earendil-works/pi-durable';
+import { type Extension } from '@earendil-works/pi-durable';
 import { FACADE_PORT, ownKernelServer } from '../kernel/loopback.ts';
 import { type ProtectedMatcher } from './origins.ts';
 export declare const BROWSER_GUARD = "slicc-browser-guard";
@@ -8,4 +8,4 @@ export declare function foreignKernel(url: string): boolean;
 export declare function forbidden(url: string, matcher: ProtectedMatcher): boolean;
 export declare function candidates(raw: string): string[];
 export declare function refused(command: string, matcher: ProtectedMatcher): boolean;
-export declare function browserGuard(origins: readonly string[], tools: readonly ToolRegistration[]): Extension;
+export declare function browserGuard(origins: readonly string[]): Extension;

package/dist/types/codemode/index.d.ts

@@ -25,7 +25,7 @@ export interface CodemodeOptions {
     extra?: (api: ToolExecutionApi, agent: Agent, context: Context) => Promise<CodemodeExtra>;
 }
 export declare function codemodeDescription(declared: readonly ToolRegistration[], discovery?: boolean): string;
-export declare function callNested(tool: ToolRegistration, args: unknown, api: ToolExecutionApi, context: Context, id: string): Promise<unknown>;
+export declare function callNested(name: string, args: unknown, api: ToolExecutionApi, context: Context): Promise<unknown>;
 export declare function formatOutput(output: readonly CodemodeOutputItem[]): CodemodeOutputItem[];
 export declare function joinText(items: readonly CodemodeOutputItem[]): CodemodeOutputItem[];
 export declare function formatError(error: CodemodeError, calls: CodemodeResult['calls']): string;

package/dist/types/scoops/extension.d.ts

@@ -1,5 +1,5 @@
 import type { Context } from '@earendil-works/chord';
-import { type ConversationId, type Extension, type Submission, type ToolRegistration, type Tx } from '@earendil-works/pi-durable';
+import { type ConversationId, type Extension, type Submission, type Tx } from '@earendil-works/pi-durable';
 import { type ScoopRecord } from '../agents.ts';
 import { type Layout } from '../layout.ts';
 import type { LickEvent } from '../licks/licks.ts';
@@ -73,5 +73,5 @@ export declare function scoopsExtension(tasks: ReturnType<typeof scoopTasks>, la
 export declare function allowed(record: Pick<ScoopRecord, 'folder'> & {
     roots?: ScoopRecord['roots'];
 }, coneCwd: string, path: string, writing: boolean, reads?: readonly string[], own?: string): boolean;
-export declare function guardExtension(lookup: Lookup, tools: readonly ToolRegistration[]): Extension;
+export declare function guardExtension(lookup: Lookup): Extension;
 export {};

package/dist/types/scoops/index.d.ts

@@ -6,9 +6,10 @@ import type { ProcessGroups } from '../kernel/groups.ts';
 import { type Layout } from '../layout.ts';
 import type { Licks } from '../licks/licks.ts';
 import { type Roles } from '../roles/roles.ts';
+import type { Choosable } from '../selection.ts';
 import { type CliOptions } from './cli.ts';
 import { type ControlPlane } from './requests.ts';
-import { type Scoops } from './service.ts';
+import { type EnvOf, type Scoops } from './service.ts';
 export declare const BUILTIN_ROLES: string[];
 export declare const PNPM_HOME = "/home/.local/share/pnpm";
 export declare const BIN_DIR = "/usr/local/bin";
@@ -34,6 +35,7 @@ export interface AttachOptions {
     mcp?: (names: readonly string[]) => ToolRegistration[];
     layout?: Layout;
     enforced?: boolean;
+    envOf: EnvOf;
     spools?: Spools;
     agentDir?: string;
 }
@@ -48,6 +50,7 @@ export interface ScoopsRuntime {
 }
 export interface ScoopsSetup {
     scoops: Scoops;
+    choosable: Choosable;
     attach(options: AttachOptions, context: Context): Promise<ScoopsRuntime>;
 }
 export declare const COMMANDS: string[];

package/dist/types/scoops/service.d.ts

@@ -1,11 +1,12 @@
 import type { Context } from '@earendil-works/chord';
-import { type AgentChange, type AnyTask, type Conversation, type Harness, type ToolRegistration } from '@earendil-works/pi-durable';
+import { type AgentChange, type AnyTask, type Conversation, type ConversationId, type Harness, type ToolRegistration } from '@earendil-works/pi-durable';
 import type { ExecutionEnv } from '@earendil-works/pi-durable/env';
 import { type Agents, type AgentsState, type Mark, type ScoopRecord } from '../agents.ts';
 import type { ProcessGroups } from '../kernel/groups.ts';
 import { type Layout } from '../layout.ts';
 import type { Licks } from '../licks/licks.ts';
 import type { Role } from '../roles/roles.ts';
+import type { Choosable } from '../selection.ts';
 export { SCOOPS_ROOT } from '../layout.ts';
 export declare const LEDGER_SIZE = 512;
 export type Feed = {
@@ -43,6 +44,7 @@ export interface ScoopTasks {
     reporter: AnyTask;
     wait: AnyTask;
 }
+export type EnvOf = (conversationId: ConversationId, context: Context) => Promise<Pick<ExecutionEnv, 'canonicalPath'> | undefined>;
 export interface ScoopsHost {
     harness: Harness;
     agents: Agents;
@@ -51,6 +53,7 @@ export interface ScoopsHost {
     tools?: readonly ToolRegistration[];
     reads?: () => readonly string[];
     files?: Pick<ExecutionEnv, 'remove' | 'createDir'>;
+    envOf?: EnvOf;
     mcp?: (names: readonly string[]) => ToolRegistration[];
     layout?: Layout;
     enforced?: boolean;
@@ -102,6 +105,7 @@ export declare function tail(conversation: Conversation, context: Context): Prom
 export declare function turnStart(conversation: Conversation, context: Context): Promise<number>;
 export declare function coneOf(state: Readonly<AgentsState>, conversation: number): string | undefined;
 export declare function findScoop(state: Readonly<AgentsState>, handle: string, cone: string | null): [string, ScoopRecord] | undefined;
+export declare function choosable(tools: readonly ToolRegistration[]): Choosable;
 export declare function askerName(state: Readonly<AgentsState>, asker: string | null): string;
 export declare function createScoops(host: Promise<ScoopsHost>, tasks: () => ScoopTasks): {
     detach: (made: readonly number[], target: string, context: Context) => Promise<void>;

package/dist/types/secrets/extension.d.ts

@@ -1,5 +1,5 @@
-import type { Context, JsonValue } from '@earendil-works/chord';
-import { type AgentChange, type Extension, type Harness, type Storage, type ToolExecutionResult } from '@earendil-works/pi-durable';
+import type { JsonValue } from '@earendil-works/chord';
+import { type Extension, type ToolExecutionResult } from '@earendil-works/pi-durable';
 import type { Names, SecretName } from './names.ts';
 import type { Scrub } from './scrub.ts';
 import type { Vault } from './vault.ts';
@@ -23,8 +23,6 @@ export declare function secretsEntry(names: readonly SecretName[]): {
     }[];
 };
 export declare function shellGrants(names: Pick<Names, 'state'>): (argv: readonly string[]) => readonly string[];
-export declare function pinned<T extends AgentChange>(change: T): T;
-export declare function repin(harness: Pick<Harness, 'conversation'>, storage: Pick<Storage, 'scanConversations'>, context: Context): Promise<number>;
 export declare function secretsExtension(deps: {
     names: Pick<Names, 'state'>;
     vault: Pick<Vault, 'ready' | 'texts'>;

package/dist/types/selection.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from '@earendil-works/chord';
+import { type AgentState, type ConversationId, type ConversationInit, type Harness, type HarnessOptions, type Storage } from '@earendil-works/pi-durable';
+export type Choosable = (tool: string) => boolean;
+type Field = keyof AgentState;
+export declare const SELECTION: readonly Field[];
+export declare const SelectionDoc: import("@earendil-works/pi-durable").SessionDocToken<{
+    version: number;
+}>;
+export declare const SELECTION_VERSION = 1;
+export declare function storedAgent(harness: Pick<Harness, 'snapshot'>, conversationId: ConversationId, context: Context): Promise<AgentState>;
+export declare function copyAgent(from: AgentState, fields?: readonly Field[]): ConversationInit;
+export declare function unfrozen(agent: AgentState, choosable: Choosable): boolean;
+export declare function unfreezeCreated(choosable: Choosable): HarnessOptions['conversationCreated'];
+export declare function unfreeze(harness: Pick<Harness, 'snapshot' | 'commit'>, storage: Pick<Storage, 'scanConversations'>, choosable: Choosable, context: Context): Promise<number>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "5.5.2",
+  "version": "5.5.4",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -66,7 +66,7 @@
     "@ai-ecoverse/slicc-kernel": "1.100.3",
     "@ai-ecoverse/slicc-scrub": "1.0.0",
     "@ai-ecoverse/slicc-shared-web": "1.21.0",
-    "@ai-ecoverse/slicc-spectrum": "1.80.0",
+    "@ai-ecoverse/slicc-spectrum": "1.81.0",
     "@ai-ecoverse/wasm-bash": "5.3.0-18",
     "@ai-ecoverse/wasm-coreutils": "9.12.0-7",
     "@ai-ecoverse/wasm-git": "2.55.0-15",