connection-centric 0.5.0 → 0.6.0

package/GUIDE.md

@@ -48,6 +48,7 @@ A tool lapses after 90 days unused. The person disconnects it from Me, or with `
 - **active-day**: a day the person did something kept. Shown to them alone, never ranked.
 - **me**: the person themselves: their display name, photo, and their own switch for the assistant.
 - **assistant**: Centric's, which answers a person's questions from what they can see and corrects a message they are writing. It is not a connected tool: it never acts, and asking it needs the person's own switch on.
+- **assistant-limit**: what one person's assistant may cost per 5 hours and per week. `show` says how much of yours is used and when it refills; an Operator lists everyone's spend and raises one person's limit. A question past it is refused with when to try again.
 - **conversation**: a person's questions to the assistant and its answers, theirs alone; deleted outright.
 - **memory**: a line the assistant keeps about a person because they told it to, read before each of their questions; theirs alone to see, add and delete.
 - **linked-system**: a firm's own system, such as its stores or accounts, that its Company's admins link so its people's assistant can read from it, through its tools that only read.

package/commands.mjs

@@ -40,7 +40,7 @@ const enc = encodeURIComponent;
 const qs = (o) => { const p = new URLSearchParams(Object.entries(o).filter(([, v]) => v != null && v !== false).map(([k, v]) => [k, v === true ? "1" : String(v)])); return p.size ? `?${p}` : ""; };
 // Rule 9: what a list or a place prints, the same everywhere.
 const listed = (items, more = null) => ({ items, more });
-const meShown = async (c) => { const m = await c.get("/api/me"); return { identity: m.identity, assistant: m.assistant, speech: m.speech, opened_directs: m.opened_directs, application: m.application, operator: m.operator, containers: m.containers.length }; };
+const meShown = async (c) => { const m = await c.get("/api/me"); return { identity: m.identity, assistant: m.assistant, speech: m.speech, claude: m.claude, opened_directs: m.opened_directs, application: m.application, operator: m.operator, containers: m.containers.length }; };
 const newest = (x, y) => (y.last?.id ?? 0) - (x.last?.id ?? 0); // a place with nothing in it yet goes last
 
 // Rule 11: a moment is shown in India's time, ISO 8601 with +05:30; a day stays YYYY-MM-DD. Field names stay the API's.
@@ -223,8 +223,8 @@ export const COMMANDS = [
     run: (c, a) => (a.before && a.after ? refuse("--before or --after, not both") : c.get(`/api/messages${qs({ channel: a.channel, before: a.before, after: a.after, limit: a.limit, unread: a.unread, search: a.search })}`)) },
   { noun: "zone", verb: "list", flags: { in: { ...IN, kind: "project" } }, about: "A Project's zones.",
     run: async (c, a) => listed((await c.get(`/api/containers/${a.in}?documents=0`)).zones) },
-  { noun: "document", verb: "list", flags: { in: IN, folder: { kind: "folder", about: "only what is in this folder" } }, about: "A container's documents, newest revision first.",
-    run: async (c, a) => listed((await c.get(`/api/containers/${a.in}/documents`)).filter((d) => !a.folder || d.folder_id === a.folder)) },
+  { noun: "document", verb: "list", flags: { in: IN, folder: { kind: "folder", about: "only what is in this folder" }, before: { kind: "words", about: "the next page, from the more: of the one before" } }, about: "A container's documents, newest revision first, fifty at a time.",
+    run: async (c, a) => { const p = await c.get(`/api/containers/${a.in}/documents${qs({ sort: "newest", folder: a.folder, before: a.before })}`); return listed(p.items, p.more); } },
   { noun: "document", verb: "show", target: { name: "document", kind: "document" }, flags: { contents: { kind: "bool", about: "with what is inside its current revision" } },
     about: "One document: its revisions, issuances and acknowledgements.",
     run: (c, a) => c.get(`/api/documents/${a.document}${a.contents ? "?contents=1" : ""}`) },
@@ -384,8 +384,8 @@ export const COMMANDS = [
       await c.save(path, bytes);
       return { document: d.document.id, revision: r.n, path, bytes: bytes.length, sha256_hex };
     } },
-  { noun: "folder", verb: "make", flags: { in: IN, name: { kind: "words", need: true }, parent: { kind: "folder", about: "the folder it goes in; the top of Docs if left out" } }, about: "Makes a folder among a container's documents: staff only.",
-    run: (c, a) => c.post(`/api/containers/${a.in}/folders`, { name: a.name, parent_id: a.parent }) },
+  { noun: "folder", verb: "make", flags: { in: IN, name: { kind: "words", need: true }, parent: { kind: "folder", about: "the folder it goes in; the top of Docs if left out" }, channel: { kind: "channel", about: "a private channel you read: the folder is its own, for its documents alone" } }, about: "Makes a folder among a container's documents: staff only.",
+    run: (c, a) => c.post(`/api/containers/${a.in}/folders`, { name: a.name, parent_id: a.parent, channel_id: a.channel }) },
   { noun: "folder", verb: "edit", target: { name: "folder", kind: "folder" }, flags: { name: { kind: "words" }, parent: { kind: "folder", none: true, about: "a folder, or none for the top of Docs" } },
     about: "Renames a folder, or moves it into another; never into itself.",
     run: (c, a) => (a.name === undefined && a.parent === undefined ? refuse("say what changes: --name or --parent") : c.patch(`/api/folders/${a.folder}`, { name: a.name, parent_id: a.parent })) },
@@ -482,13 +482,15 @@ export const COMMANDS = [
   // ── me and the assistant ──
   { noun: "me", verb: "edit", flags: { "display-name": { kind: "words", about: "what you call yourself, everywhere you work" }, assistant: { kind: "choice", of: ["on", "off"], about: "your own switch for Centric's assistant (ADR 0002)" },
       language: { kind: "choice", of: ["en", "gu", "hi"], about: "what your assistant and your digest answer in" },
-      speech: { kind: "choice", of: ["on", "off"], about: "your own switch for read aloud, transcripts and dictation (ADR 0019)" } },
-    about: "Changes your display name, switches your assistant or speech on or off, or sets the assistant's language.",
+      speech: { kind: "choice", of: ["on", "off"], about: "your own switch for read aloud, transcripts and dictation (ADR 0019)" },
+      claude: { kind: "choice", of: ["on", "off"], about: "your own switch for Claude on your questions and reports; Anthropic keeps what it is sent up to 30 days (ADR 0020)" } },
+    about: "Changes your display name, switches your assistant, speech or Claude on or off, or sets the assistant's language.",
     async run(c, a) {
-      if (a["display-name"] === undefined && a.assistant === undefined && a.language === undefined && a.speech === undefined) refuse("say what changes: --display-name, --assistant, --language or --speech");
+      if (a["display-name"] === undefined && a.assistant === undefined && a.language === undefined && a.speech === undefined && a.claude === undefined) refuse("say what changes: --display-name, --assistant, --language, --speech or --claude");
       if (a["display-name"] !== undefined) await c.patch("/api/me", { display_name: a["display-name"] });
       if (a.assistant !== undefined || a.language !== undefined) await c.patch("/api/me/assistant", { on: a.assistant && a.assistant === "on", lang: a.language });
       if (a.speech !== undefined) await c.patch("/api/me/speech", { on: a.speech === "on" });
+      if (a.claude !== undefined) await c.patch("/api/me/claude", { on: a.claude === "on" });
       return meShown(c);
     } },
   { noun: "me", verb: "set-photo", flags: { path: { ...PATH, about: "a square JPEG, PNG or WebP, 300 KB at most" } }, about: "Sets the photo shown beside your name.",
@@ -496,7 +498,7 @@ export const COMMANDS = [
   { noun: "me", verb: "remove-photo", flags: {}, about: "Takes your photo away; it is gone, kept nowhere.", run: (c) => c.del("/api/me/photo") },
   { noun: "assistant", verb: "question", target: { name: "text", kind: "words" }, flags: { conversation: { kind: "id", about: "to go on from one" }, focus: { kind: "focus", about: "a Project, Company or channel for a new conversation to keep to" },
       path: { kind: "path", about: "a file for it to read, kept with the conversation" } },
-    about: "Asks Centric's assistant, which answers from what you can see. Only while your own switch is on; it counts against the day's share.",
+    about: "Asks Centric's assistant, which answers from what you can see. Only while your own switch is on; it counts against your Assistant limit.",
     async run(c, a) {
       const up = a.path && (await c.upload(a.path)); // uploaded as the person, linked to no message: theirs alone
       return c.post("/api/assist", { q: a.text, conversation: a.conversation, focus: a.focus, ...(up && { files: [{ path: up.path, name: up.name }] }) });
@@ -504,6 +506,19 @@ export const COMMANDS = [
   { noun: "assistant", verb: "correct", target: { name: "text", kind: "words" }, flags: {},
     about: "The assistant puts a message's spelling, grammar and punctuation right; it is still yours to send.",
     run: (c, a) => c.post("/api/assist/correct", { text: a.text }) },
+  // The Assistant limit (CONTEXT.md, issue 448): how much of one's own is used; an Operator's view of every person's
+  // spend, and raising one person's limit.
+  { noun: "assistant-limit", verb: "show", flags: {}, about: "How much of your Assistant limit is used, and when it refills.",
+    run: (c) => c.get("/api/assistant/limit") },
+  { noun: "assistant-limit", verb: "list", flags: {}, about: "Each person's assistant spend in rupees. Operators only.",
+    run: (c) => c.get("/api/ops/assistant-spend") },
+  { noun: "assistant-limit", verb: "edit", target: { name: "identity", kind: "identity" },
+    flags: { add: { kind: "int", about: "rupees now" }, "five-hours": { kind: "int", about: "₹ per 5 hours" }, week: { kind: "int", about: "₹ per week" } },
+    about: "Raises one person's Assistant limit. Operators only.",
+    run: (c, a) => {
+      if (a.add === undefined && a["five-hours"] === undefined && a.week === undefined) refuse("say what changes: --add, --five-hours or --week");
+      return c.post(`/api/ops/assistant-limit/${a.identity}`, { credit_inr: a.add, session_inr: a["five-hours"], week_inr: a.week });
+    } },
   { noun: "conversation", verb: "delete", target: { name: "conversation", kind: "id" }, flags: {}, about: "Deletes a conversation with the assistant outright; it leaves no tombstone.",
     run: (c, a) => c.del(`/api/assistant/conversations/${a.conversation}`) },
   // A firm's own system its assistant reads from (CONTEXT.md Linked system): its admins link and remove one; its people list them.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "connection-centric",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "The centric command: what a person does in Connection-Centric, done as them from a terminal, a script, or a program such as Claude Code.",
   "type": "module",
   "bin": {