@kubitnodes/stellaris 0.3.5 → 0.3.7

package/dist/cli/index.js

@@ -6,7 +6,7 @@ import path7 from "node:path";
 import { Command } from "commander";
 
 // packages/board-core/dist/board.js
-import { readdir as readdir3, readFile as readFile5, rename as rename3, stat as stat2 } from "node:fs/promises";
+import { mkdir as mkdir4, readdir as readdir3, readFile as readFile5, rename as rename3, stat as stat2 } from "node:fs/promises";
 import path6 from "node:path";
 import { decodeTime, monotonicFactory } from "ulid";
 import { z as z12 } from "zod";
@@ -56,7 +56,8 @@ var VERB_NAMES = [
   "plan_task",
   "advance_task",
   "configure_project",
-  "archive_project"
+  "archive_project",
+  "remove_knowledge"
 ];
 var VerbNameSchema = z2.enum(VERB_NAMES);
 var CharterTriggerSchema = z2.enum(["user_post", "ops_event", "heartbeat"]);
@@ -100,6 +101,7 @@ var MEMBER_VERBS = [
   "join_project",
   "leave_project",
   "write_knowledge",
+  "remove_knowledge",
   "plan_task",
   "advance_task"
 ];
@@ -301,11 +303,23 @@ function mayHoldStage(member, task2) {
   return !(stage.gate && task2.stages.slice(0, index).some((s) => s.holders.includes(member.name)));
 }
 var ModelNameSchema = z3.string().trim().min(1).max(120).regex(/^[\w.:/[\]-]+$/, "a model name is one word of letters, digits, and . _ : / - [ ]");
+var EffortSchema = z3.string().trim().min(1).max(32).regex(/^[a-z][a-z0-9_-]*$/, "an effort is one lowercase word, such as high");
+var EffortOptionSchema = z3.object({
+  id: EffortSchema,
+  description: z3.string().default("")
+});
 var ModelOptionSchema = z3.object({
   id: ModelNameSchema,
   name: z3.string(),
   description: z3.string().default(""),
-  isDefault: z3.boolean().default(false)
+  isDefault: z3.boolean().default(false),
+  efforts: z3.array(EffortOptionSchema).default([]),
+  defaultEffort: EffortSchema.optional()
+});
+var RunnerModelsSchema = z3.object({
+  runner: NameSchema,
+  cli: CliKindSchema,
+  models: z3.array(ModelOptionSchema)
 });
 var AgentStatusSchema = z3.enum(["active", "retired"]);
 var AgentSchema = z3.object({
@@ -313,6 +327,8 @@ var AgentSchema = z3.object({
   role: NameSchema,
   cli: CliKindSchema.nullable(),
   model: z3.string().optional(),
+  /** The reasoning effort set for the agent's turns; the model's own default applies otherwise. */
+  effort: z3.string().optional(),
   /** The runner preferred for the agent's turns where nothing else decides; any runner with its CLI otherwise. */
   homeRunner: NameSchema.optional(),
   memberships: z3.array(NameSchema),
@@ -334,6 +350,8 @@ var MemberSchema = z3.object({
   model: z3.string().optional(),
   /** The model the CLI reported on the citizen's last turn. */
   lastModel: z3.string().optional(),
+  /** The reasoning effort configured on the record, if any; the model's own default applies otherwise. */
+  effort: z3.string().optional(),
   /** The citizen's own skills, by name. */
   skills: z3.array(NameSchema).default([]),
   memberships: z3.array(NameSchema),
@@ -523,6 +541,12 @@ var KnowledgeSchema = z3.object({
   updatedBy: NameSchema,
   updatedAt: IsoDateTimeSchema
 });
+var RemovedKnowledgeSchema = z3.object({
+  topic: NameSchema,
+  project: NameSchema.nullable(),
+  removedBy: NameSchema,
+  removedAt: IsoDateTimeSchema
+});
 var ProposalFrontmatterSchema = z3.object({
   id: UlidSchema,
   kind: ProposalKindSchema,
@@ -619,6 +643,11 @@ var VerbInputs = {
     topic: NameSchema,
     body: z4.string().min(1)
   }),
+  remove_knowledge: z4.object({
+    /** As for write_knowledge: a project you belong to, or null for society knowledge. */
+    project: NameSchema.nullable().default(null),
+    topic: NameSchema
+  }),
   plan_task: z4.object({
     task_id: UlidSchema,
     stages: z4.array(PlanEditStageSchema),
@@ -668,6 +697,7 @@ var BOARD_EVENT_TYPES = [
   "agent.joined",
   "agent.left",
   "knowledge.written",
+  "knowledge.removed",
   "skill.promoted",
   "runner.added",
   "user.signed_in",
@@ -845,6 +875,8 @@ var TurnJobSchema = z6.object({
   role: NameSchema,
   cli: CliKindSchema,
   model: z6.string().optional(),
+  /** The reasoning effort set on the agent; absent for the model's own default. */
+  effort: z6.string().optional(),
   /** A project slug, or the society scope. */
   scope: NameSchema,
   /** The thread whose conversation the turn is in; absent for the home conversation. */
@@ -1078,6 +1110,8 @@ var TurnHistoryEntrySchema = z7.object({
   trigger: z7.string(),
   exitReason: z7.string().nullable(),
   costUsd: z7.number(),
+  /** The tokens the turn used; absent for turns logged before turns recorded them. */
+  usage: UsageSchema.optional(),
   model: z7.string().nullable(),
   summary: z7.string().nullable(),
   error: z7.string().nullable(),
@@ -1261,7 +1295,7 @@ var RunnerConfigSchema = z10.object({
 });
 
 // packages/shared/dist/version.js
-var STELLARIS_VERSION = "0.3.5";
+var STELLARIS_VERSION = "0.3.7";
 
 // packages/board-core/dist/errors.js
 var BoardError = class extends Error {
@@ -2294,6 +2328,10 @@ var BoardPaths = class {
   pausedFile() {
     return path5.join(this.state(), "paused.json");
   }
+  /** Removed knowledge topics, set aside outside the projection, by scope. */
+  removedKnowledge(scope) {
+    return path5.join(this.state(), "removed-knowledge", scope);
+  }
 };
 
 // packages/board-core/dist/tokens.js
@@ -2327,6 +2365,7 @@ var TurnHistoryPayloadSchema = z12.object({
   trigger: z12.string().default("manual"),
   exitReason: z12.string().nullable().default(null),
   costUsd: z12.number().default(0),
+  usage: UsageSchema.optional(),
   model: z12.string().nullable().default(null),
   summary: z12.string().nullable().default(null),
   error: z12.string().nullable().default(null),
@@ -2386,6 +2425,7 @@ var OPS_CHANNEL_RETIRED = "ops-channel-retired";
 var DECISIONS_CHANNEL_RETIRED = "decisions-channel-retired";
 var THREAD_CONVERSATIONS = "thread-conversations";
 var ASKS_CHANNEL_OPENED = "asks-channel-opened";
+var KNOWLEDGE_REMOVAL = "knowledge-removal-granted";
 var PLANNING_ROLES = [USER_ROLE, "steward", "concierge"];
 var REALLOCATING_ROLES = [USER_ROLE, "steward", "concierge"];
 var PROFILE_TEMPLATE = "# Profile\n\nOne short paragraph, kept current: what I do well, what I am working on, and what to send my way. The board projects this into the roster the front desk reads.\n";
@@ -2575,7 +2615,8 @@ var Board = class _Board {
       OPS_CHANNEL_RETIRED,
       DECISIONS_CHANNEL_RETIRED,
       THREAD_CONVERSATIONS,
-      ASKS_CHANNEL_OPENED
+      ASKS_CHANNEL_OPENED,
+      KNOWLEDGE_REMOVAL
     ].filter((name) => !applied.includes(name));
     if (pending.length === 0) {
       return;
@@ -2604,8 +2645,22 @@ var Board = class _Board {
     if (pending.includes(ASKS_CHANNEL_OPENED)) {
       await this.openAsksChannel();
     }
+    if (pending.includes(KNOWLEDGE_REMOVAL)) {
+      await this.grantKnowledgeRemoval();
+    }
     await writeJson(file, { applied: [...applied, ...pending] });
   }
+  /**
+   * Whoever may write a scope's knowledge may remove it, so every charter granting
+   * `write_knowledge` is granted `remove_knowledge` once; seed roles have it from their seed.
+   */
+  async grantKnowledgeRemoval() {
+    for (const charter of await this.listRoles()) {
+      if (charter.verbs.includes("write_knowledge") && !charter.verbs.includes("remove_knowledge")) {
+        await this.writeRoleUnlocked(USER_NAME, { ...charter, verbs: [...charter.verbs, "remove_knowledge"] }, { verbsAdded: ["remove_knowledge"] });
+      }
+    }
+  }
   /**
    * A task sent back before tasks recorded it kept no trace outside the event log. A task still
    * short of the stage its latest `task.moved` came from is in that rework, and records it.
@@ -3837,16 +3892,7 @@ ${task2.body}`;
     const args = VerbInputs.write_knowledge.parse(input);
     await this.authorize(actor, "write_knowledge");
     return this.mutex.run(async () => {
-      if (args.project === null) {
-        if (!CURATING_ROLES.includes(actor.role)) {
-          throw new BoardError("FORBIDDEN", "society knowledge is curated by the steward and the user");
-        }
-      } else {
-        const project2 = await this.readActiveProject(args.project);
-        if (!CURATING_ROLES.includes(actor.role) && !project2.members.includes(actor.name)) {
-          throw new BoardError("FORBIDDEN", `${actor.name} is not a member of ${args.project}`);
-        }
-      }
+      await this.assertMayCurate(actor, args.project);
       const data = KnowledgeSchema.parse({
         topic: args.topic,
         project: args.project,
@@ -3866,6 +3912,52 @@ ${task2.body}`;
       return { ...data, body: args.body };
     });
   }
+  /**
+   * Retires a topic, by whoever may write it. Its file leaves the knowledge directory, so no turn,
+   * search, or digest finds it again, and is set aside under `state/removed-knowledge`, outside
+   * the projection, for the user to restore by hand. The note in the matching general channel
+   * carries no mention, as a write's does.
+   */
+  async removeKnowledge(actor, input) {
+    const args = VerbInputs.remove_knowledge.parse(input);
+    await this.authorize(actor, "remove_knowledge");
+    return this.mutex.run(async () => {
+      await this.assertMayCurate(actor, args.project);
+      const file = args.project === null ? this.paths.societyKnowledgeFile(args.topic) : this.paths.projectKnowledgeFile(args.project, args.topic);
+      if (!await exists(file)) {
+        throw new BoardError("NOT_FOUND", `${args.project ?? "the society"} has no knowledge topic ${args.topic}`);
+      }
+      const removed = RemovedKnowledgeSchema.parse({
+        topic: args.topic,
+        project: args.project,
+        removedBy: actor.name,
+        removedAt: this.now().toISOString()
+      });
+      const aside = this.paths.removedKnowledge(args.project ?? SOCIETY_SCOPE);
+      await mkdir4(aside, { recursive: true });
+      await rename3(file, path6.join(aside, `${args.topic}.${removed.removedAt.replaceAll(":", "-")}.md`));
+      await this.events.append("knowledge.removed", actor.name, {
+        topic: args.topic,
+        project: args.project
+      });
+      const where = args.project === null ? "general" : channelRef(args.project, "general");
+      await this.appendMessage(actor.name, where, `Knowledge removed: ${args.topic}. It is no longer under knowledge/${args.topic}.md${args.project === null ? " of the society" : ""}.`);
+      return removed;
+    });
+  }
+  /** Society knowledge is the steward's and the user's; a project's, its members' too. */
+  async assertMayCurate(actor, project2) {
+    if (project2 === null) {
+      if (!CURATING_ROLES.includes(actor.role)) {
+        throw new BoardError("FORBIDDEN", "society knowledge is curated by the steward and the user");
+      }
+      return;
+    }
+    const active = await this.readActiveProject(project2);
+    if (!CURATING_ROLES.includes(actor.role) && !active.members.includes(actor.name)) {
+      throw new BoardError("FORBIDDEN", `${actor.name} is not a member of ${project2}`);
+    }
+  }
   async openThread(actor, input) {
     const args = VerbInputs.open_thread.parse(input);
     await this.authorize(actor, "open_thread");
@@ -4692,6 +4784,8 @@ ${rationale}`}`);
         return this.leaveProject(actor, VerbInputs.leave_project.parse(input));
       case "write_knowledge":
         return this.writeKnowledge(actor, VerbInputs.write_knowledge.parse(input));
+      case "remove_knowledge":
+        return this.removeKnowledge(actor, VerbInputs.remove_knowledge.parse(input));
       case "plan_task":
         return this.planTask(actor, VerbInputs.plan_task.parse(input));
       case "advance_task":
@@ -4930,6 +5024,7 @@ ${rationale}`}`);
         session: parsed.session,
         exitReason: parsed.exitReason,
         costUsd: parsed.costUsd,
+        ...parsed.usage === null ? {} : { usage: parsed.usage },
         toolCalls: parsed.toolCalls,
         model: parsed.model,
         summary: parsed.status?.summary ?? null,
@@ -5386,6 +5481,7 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
       resident: charter.resident,
       ...agent2.model === void 0 ? {} : { model: agent2.model },
       ...lastModel === void 0 ? {} : { lastModel },
+      ...agent2.effort === void 0 ? {} : { effort: agent2.effort },
       skills: (await this.listAgentSkills(name)).map((skill) => skill.name),
       memberships: agent2.memberships,
       subscriptions: agent2.subscriptions,
@@ -5434,6 +5530,29 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
       return next;
     });
   }
+  /**
+   * Sets the reasoning effort a citizen's turns run with, or clears it for the model's own default.
+   * It applies from the citizen's next turn; the runner starts a warm session afresh when it changes.
+   */
+  async setAgentEffort(actor, name, effort) {
+    this.assertUser(actor, "only the user may change a citizen's reasoning effort");
+    const chosen = effort === null ? null : EffortSchema.parse(effort);
+    return this.mutex.run(async () => {
+      const current = await this.readAgent(name);
+      if (current.status !== "active" || current.cli === null) {
+        throw new BoardError("INVALID_STATE", `${name} takes no turns, so it has no effort to set`);
+      }
+      const { effort: previous, ...rest } = current;
+      const next = await this.updateAgent(name, () => chosen === null ? rest : { ...rest, effort: chosen });
+      await this.refreshMember(name);
+      await this.events.append("agent.configured", actor.name, {
+        agent: name,
+        effort: chosen,
+        previous: previous ?? null
+      });
+      return next;
+    });
+  }
   async updateAgent(name, mutate) {
     const current = await this.readAgent(name);
     const next = AgentSchema.parse(mutate(current));
@@ -6274,6 +6393,11 @@ agent.command("model <name> [model]").description("Set the model a member's turn
   const updated = await board.setAgentModel(board.userActor(), name, model ?? null);
   print(updated, () => `${updated.name} runs with ${updated.model ?? "its CLI's default model"} from its next turn`);
 });
+agent.command("effort <name> [effort]").description("Set the reasoning effort a member's turns run with, from its next turn, such as high; no effort means the model's default").action(async (name, effort) => {
+  const board = await open();
+  const updated = await board.setAgentEffort(board.userActor(), name, effort ?? null);
+  print(updated, () => `${updated.name} runs with ${updated.effort === void 0 ? "its model's default effort" : `${updated.effort} effort`} from its next turn`);
+});
 agent.command("retire <name>").description("Retire a member: no more wakes, claims released, token revoked, sessions archived").requiredOption("--reason <text>", "why").action(async (name, opts) => {
   const board = await open();
   const retired = await board.retireAgent(board.userActor(), { name, reason: opts.reason });