@dayofweek/dcli 1.9.1 → 1.10.0

package/dist/bin/dcli.js

@@ -430,6 +430,71 @@ brainSource
     }
     output(await getClient().scopeBrainSource(sourceId, opts.actor ?? null));
 });
+const brainTags = brain
+    .command("tags")
+    .description("Work with an area's tag vocabulary and resource couplings");
+brainTags
+    .command("list")
+    .description("List an area's tags (predefined hierarchical set + user-defined)")
+    .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .action(async (opts) => {
+    output(await getClient().listBrainTags(opts.area));
+});
+brainTags
+    .command("add")
+    .description("Add a user-defined tag (idempotent on the derived key)")
+    .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .requiredOption("--label <label>", "Tag label")
+    .option("--parent <key>", "Parent tag key (makes this a child tag)")
+    .option("--description <text>", "What the tag means")
+    .action(async (opts) => {
+    output(await getClient().createBrainTag({
+        areaId: opts.area,
+        label: opts.label,
+        parentKey: opts.parent,
+        description: opts.description,
+    }));
+});
+brainTags
+    .command("couplings")
+    .description("List tag/actor couplings — filter by actor, tag, source or note")
+    .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .option("--tag <key>", "Resources coupled to this tag")
+    .option("--actor <actorId>", "Resources coupled to this actor")
+    .option("--source <sourceId>", "One source's tags and actors")
+    .option("--note <noteId>", "One note/page's tags and actors")
+    .action(async (opts) => {
+    output(await getClient().listBrainCouplings({
+        areaId: opts.area,
+        tag: opts.tag,
+        actor: opts.actor,
+        source: opts.source,
+        note: opts.note,
+    }));
+});
+brainTags
+    .command("couple")
+    .description("Couple a source/note to a tag or an actor (--remove uncouples)")
+    .option("--source <sourceId>", "Source to couple")
+    .option("--note <noteId>", "Note/page to couple")
+    .option("--tag <key>", "Tag key (from `brain tags list`)")
+    .option("--actor <actorId>", "Actor id (from `brain actors list`)")
+    .option("--remove", "Remove the coupling instead of adding it")
+    .action(async (opts) => {
+    if (Boolean(opts.source) === Boolean(opts.note)) {
+        throw new Error("Pass exactly one of --source <sourceId> or --note <noteId>");
+    }
+    if (Boolean(opts.tag) === Boolean(opts.actor)) {
+        throw new Error("Pass exactly one of --tag <key> or --actor <actorId>");
+    }
+    output(await getClient().coupleBrainResource({
+        sourceId: opts.source,
+        noteId: opts.note,
+        tagKey: opts.tag,
+        actorId: opts.actor,
+        remove: opts.remove,
+    }));
+});
 auth
     .command("devices")
     .description("List your agent tokens")

package/dist/bundle/dcli.cjs

@@ -4518,6 +4518,27 @@ var DayOfWeekClient = class {
   async scopeBrainSource(sourceId, actorId) {
     return this.patch(`/brain/sources/${encodeURIComponent(sourceId)}/actor`, { actorId });
   }
+  /** The area's tag vocabulary: predefined hierarchical set + user-defined. */
+  async listBrainTags(areaId) {
+    return this.get(`/brain/tags?area=${encodeURIComponent(areaId)}`);
+  }
+  /** Add a user-defined tag to an area's vocabulary. Idempotent on the key. */
+  async createBrainTag(input) {
+    return this.post("/brain/tags", input);
+  }
+  /** Tag/actor couplings, filterable by actor, tag, source or note. */
+  async listBrainCouplings(input) {
+    const params = new URLSearchParams({ area: input.areaId });
+    if (input.tag) params.set("tag", input.tag);
+    if (input.actor) params.set("actor", input.actor);
+    if (input.source) params.set("source", input.source);
+    if (input.note) params.set("note", input.note);
+    return this.get(`/brain/tags/couplings?${params.toString()}`);
+  }
+  /** Couple (or uncouple, with remove) a source/note to a tag or an actor. */
+  async coupleBrainResource(input) {
+    return this.post("/brain/tags/couplings", input);
+  }
   /** Entities with an active customer role and no investor/partner/producer role. */
   async adminCustomersOnly() {
     return this.get("/admin/customers-only");
@@ -5144,7 +5165,7 @@ var import_promises4 = require("node:readline/promises");
 // package.json
 var package_default = {
   name: "@dayofweek/dcli",
-  version: "1.9.1",
+  version: "1.10.0",
   description: "CLI for the Day of Week AgTech platform \u2014 read data and submit proposals for review",
   license: "MIT",
   type: "module",
@@ -5532,6 +5553,42 @@ brainSource.command("scope <sourceId>").description("Scope a source to an actor
   }
   output(await getClient().scopeBrainSource(sourceId, opts.actor ?? null));
 });
+var brainTags = brain.command("tags").description("Work with an area's tag vocabulary and resource couplings");
+brainTags.command("list").description("List an area's tags (predefined hierarchical set + user-defined)").requiredOption("--area <areaId>", "Area id (from `brain list`)").action(async (opts) => {
+  output(await getClient().listBrainTags(opts.area));
+});
+brainTags.command("add").description("Add a user-defined tag (idempotent on the derived key)").requiredOption("--area <areaId>", "Area id (from `brain list`)").requiredOption("--label <label>", "Tag label").option("--parent <key>", "Parent tag key (makes this a child tag)").option("--description <text>", "What the tag means").action(async (opts) => {
+  output(await getClient().createBrainTag({
+    areaId: opts.area,
+    label: opts.label,
+    parentKey: opts.parent,
+    description: opts.description
+  }));
+});
+brainTags.command("couplings").description("List tag/actor couplings \u2014 filter by actor, tag, source or note").requiredOption("--area <areaId>", "Area id (from `brain list`)").option("--tag <key>", "Resources coupled to this tag").option("--actor <actorId>", "Resources coupled to this actor").option("--source <sourceId>", "One source's tags and actors").option("--note <noteId>", "One note/page's tags and actors").action(async (opts) => {
+  output(await getClient().listBrainCouplings({
+    areaId: opts.area,
+    tag: opts.tag,
+    actor: opts.actor,
+    source: opts.source,
+    note: opts.note
+  }));
+});
+brainTags.command("couple").description("Couple a source/note to a tag or an actor (--remove uncouples)").option("--source <sourceId>", "Source to couple").option("--note <noteId>", "Note/page to couple").option("--tag <key>", "Tag key (from `brain tags list`)").option("--actor <actorId>", "Actor id (from `brain actors list`)").option("--remove", "Remove the coupling instead of adding it").action(async (opts) => {
+  if (Boolean(opts.source) === Boolean(opts.note)) {
+    throw new Error("Pass exactly one of --source <sourceId> or --note <noteId>");
+  }
+  if (Boolean(opts.tag) === Boolean(opts.actor)) {
+    throw new Error("Pass exactly one of --tag <key> or --actor <actorId>");
+  }
+  output(await getClient().coupleBrainResource({
+    sourceId: opts.source,
+    noteId: opts.note,
+    tagKey: opts.tag,
+    actorId: opts.actor,
+    remove: opts.remove
+  }));
+});
 auth.command("devices").description("List your agent tokens").action(async () => {
   const client = getClient();
   const devices = await client.listDevices();

package/dist/client.d.ts

@@ -251,6 +251,31 @@ export declare class DayOfWeekClient {
     }): Promise<any>;
     /** Scope a source to an actor (actorId null returns it to area level). */
     scopeBrainSource(sourceId: string, actorId: string | null): Promise<any>;
+    /** The area's tag vocabulary: predefined hierarchical set + user-defined. */
+    listBrainTags(areaId: string): Promise<any>;
+    /** Add a user-defined tag to an area's vocabulary. Idempotent on the key. */
+    createBrainTag(input: {
+        areaId: string;
+        label: string;
+        parentKey?: string;
+        description?: string;
+    }): Promise<any>;
+    /** Tag/actor couplings, filterable by actor, tag, source or note. */
+    listBrainCouplings(input: {
+        areaId: string;
+        tag?: string;
+        actor?: string;
+        source?: string;
+        note?: string;
+    }): Promise<any>;
+    /** Couple (or uncouple, with remove) a source/note to a tag or an actor. */
+    coupleBrainResource(input: {
+        sourceId?: string;
+        noteId?: string;
+        tagKey?: string;
+        actorId?: string;
+        remove?: boolean;
+    }): Promise<any>;
     /** Entities with an active customer role and no investor/partner/producer role. */
     adminCustomersOnly(): Promise<any>;
     /** Tips mailed to press@mail.dayofweek.com, read by the press-scan skill. */

package/dist/client.js

@@ -378,6 +378,31 @@ export class DayOfWeekClient {
     async scopeBrainSource(sourceId, actorId) {
         return this.patch(`/brain/sources/${encodeURIComponent(sourceId)}/actor`, { actorId });
     }
+    /** The area's tag vocabulary: predefined hierarchical set + user-defined. */
+    async listBrainTags(areaId) {
+        return this.get(`/brain/tags?area=${encodeURIComponent(areaId)}`);
+    }
+    /** Add a user-defined tag to an area's vocabulary. Idempotent on the key. */
+    async createBrainTag(input) {
+        return this.post("/brain/tags", input);
+    }
+    /** Tag/actor couplings, filterable by actor, tag, source or note. */
+    async listBrainCouplings(input) {
+        const params = new URLSearchParams({ area: input.areaId });
+        if (input.tag)
+            params.set("tag", input.tag);
+        if (input.actor)
+            params.set("actor", input.actor);
+        if (input.source)
+            params.set("source", input.source);
+        if (input.note)
+            params.set("note", input.note);
+        return this.get(`/brain/tags/couplings?${params.toString()}`);
+    }
+    /** Couple (or uncouple, with remove) a source/note to a tag or an actor. */
+    async coupleBrainResource(input) {
+        return this.post("/brain/tags/couplings", input);
+    }
     /** Entities with an active customer role and no investor/partner/producer role. */
     async adminCustomersOnly() {
         return this.get("/admin/customers-only");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dayofweek/dcli",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "CLI for the Day of Week AgTech platform \u2014 read data and submit proposals for review",
   "license": "MIT",
   "type": "module",