@islamihab/kds 0.2.1 → 0.2.3

package/index.js

@@ -14383,6 +14383,9 @@ config(en_default());
 // ../../packages/env/src/cli.ts
 var env = createEnv({
   server: {
+    KDS_ACTOR: exports_external.enum(["agent", "human"]).optional(),
+    KDS_HARNESS: exports_external.string().optional(),
+    KDS_MODEL: exports_external.string().optional(),
     KDS_CONFIG_DIR: exports_external.string().optional(),
     KDS_NO_UPDATE_CHECK: exports_external.string().optional(),
     KDS_SERVER_URL: exports_external.url().optional()
@@ -14594,7 +14597,7 @@ import { join } from "path";
 // package.json
 var package_default = {
   name: "cli",
-  version: "0.2.1",
+  version: "0.2.3",
   private: true,
   type: "module",
   bin: {
@@ -17623,7 +17626,62 @@ function forwardErrorData(errorData, error51) {
   error51.data = jsonToConvex(errorData);
   return error51;
 }
+// src/lib/actor.ts
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+var HARNESSES = [
+  { env: "CLAUDECODE", label: "Claude Code" },
+  { env: "CLAUDE_CODE_ENTRYPOINT", label: "Claude Code" },
+  { env: "CODEX_SANDBOX", label: "Codex" },
+  { env: "CURSOR_AGENT", label: "Cursor" },
+  { env: "AI_AGENT", label: undefined }
+];
+var readEnv = (name) => {
+  const value = process.env[name]?.trim();
+  return value ? value : undefined;
+};
+var detectHarness = () => {
+  if (env.KDS_HARNESS)
+    return env.KDS_HARNESS;
+  for (const { env: name, label } of HARNESSES) {
+    const value = readEnv(name);
+    if (value)
+      return label ?? value;
+  }
+  return;
+};
+var TRANSCRIPT_TAIL_BYTES = 64 * 1024;
+var claudeCodeModel = async () => {
+  const sessionId = readEnv("CLAUDE_CODE_SESSION_ID");
+  if (!sessionId)
+    return;
+  try {
+    const projects = join2(homedir2(), ".claude", "projects");
+    const glob = new Bun.Glob(`*/${sessionId}.jsonl`);
+    for await (const match of glob.scan({ cwd: projects, absolute: true })) {
+      const file2 = Bun.file(match);
+      const tail = await file2.slice(Math.max(0, file2.size - TRANSCRIPT_TAIL_BYTES)).text();
+      const models = [...tail.matchAll(/"model"\s*:\s*"([^"]+)"/g)];
+      return models.at(-1)?.[1];
+    }
+  } catch {}
+  return;
+};
+var detectModel = async () => env.KDS_MODEL ?? readEnv("ANTHROPIC_MODEL") ?? await claudeCodeModel();
+var detectAgent = async () => {
+  if (env.KDS_ACTOR === "human")
+    return;
+  const harness = detectHarness();
+  if (!harness && env.KDS_ACTOR !== "agent")
+    return;
+  const model = await detectModel();
+  return { harness: harness ?? "unidentified harness", ...model ? { model } : {} };
+};
+var claim;
+var agentClaim = () => claim ??= detectAgent();
+
 // src/lib/backend.ts
+var attributed = (args, agent) => agent === undefined ? args : { ...args, agent };
 var backendClient = async () => {
   const config2 = await loadConfig();
   if (!config2)
@@ -17641,7 +17699,17 @@ var backendClient = async () => {
       throw new Error("The auth server returned no Convex token");
     client3.setAuth(data.token);
   }
-  return client3;
+  return {
+    query: (reference, ...args) => client3.query(reference, ...args),
+    mutation: async (reference, args) => {
+      const widened = reference;
+      return await client3.mutation(widened, attributed(args, await agentClaim()));
+    },
+    action: async (reference, args) => {
+      const widened = reference;
+      return await client3.action(widened, attributed(args, await agentClaim()));
+    }
+  };
 };
 
 // src/lib/prompt.ts
@@ -17804,6 +17872,72 @@ var logout = command({
   }
 });
 
+// src/lib/activity.ts
+var SOURCE_LABELS = { github: "GitHub", agent: "Agent" };
+var actorLabel = (via, agent) => {
+  if (via === undefined)
+    return "You";
+  const named = [agent?.model, agent?.harness].filter(Boolean).join(" \xB7 ");
+  return named ? `${SOURCE_LABELS[via]} (${named})` : SOURCE_LABELS[via];
+};
+var issueActivityLine = (detail) => {
+  const label = detail.kind.replaceAll("_", " ");
+  switch (detail.kind) {
+    case "created":
+    case "description_changed":
+      return label;
+    case "title_changed":
+    case "status_changed":
+    case "priority_changed":
+    case "disposition_changed":
+    case "estimate_changed":
+    case "due_date_changed":
+    case "branch_changed":
+    case "pr_changed":
+    case "project_changed":
+    case "milestone_changed":
+    case "parent_changed":
+      return `${label}: ${detail.from ?? "none"} \u2192 ${detail.to ?? "none"}`;
+    case "label_added":
+    case "label_removed":
+    case "attachment_added":
+    case "attachment_removed":
+      return `${label}: ${detail.name}`;
+    case "child_added":
+    case "child_removed":
+      return `${label}: ${detail.identifier}`;
+    case "relation_added":
+    case "relation_removed":
+      return `${label}: ${detail.relation.replaceAll("_", " ")} ${detail.identifier}`;
+  }
+};
+var projectActivityLine = (detail) => {
+  const label = detail.kind.replaceAll("_", " ");
+  switch (detail.kind) {
+    case "created":
+    case "summary_changed":
+    case "description_changed":
+    case "milestones_reordered":
+      return label;
+    case "name_changed":
+    case "status_changed":
+    case "health_changed":
+    case "target_date_changed":
+    case "repo_changed":
+    case "milestone_renamed":
+      return `${label}: ${detail.from ?? "none"} \u2192 ${detail.to ?? "none"}`;
+    case "milestone_added":
+    case "milestone_removed":
+    case "milestone_description_changed":
+      return `${label}: ${detail.name}`;
+    case "milestone_target_date_changed":
+      return `${label}: ${detail.name} ${detail.from ?? "none"} \u2192 ${detail.to ?? "none"}`;
+    case "issue_added":
+    case "issue_removed":
+      return `${label}: ${detail.identifier}`;
+  }
+};
+
 // src/commands/auth/status.ts
 var status = command({
   name: "status",
@@ -17813,6 +17947,9 @@ var status = command({
     if (!user)
       return console.log("Not signed in.");
     console.log(`Signed in as ${user.name} <${user.email}>`);
+    const agent = await agentClaim();
+    if (agent)
+      console.log(`Acting as ${actorLabel("agent", agent)}; changes will show in the inbox.`);
   }
 });
 
@@ -17823,57 +17960,55 @@ var auth = group({
   commands: [login, logout, status]
 });
 
-// src/lib/attachments.ts
-import { basename } from "path";
-var attachFiles = async (client3, issueId, paths) => {
-  if (paths.length === 0)
-    return [];
-  const files = paths.map((path) => ({ path, file: Bun.file(path) }));
-  for (const { path, file: file2 } of files) {
-    if (!await file2.exists())
-      throw new Error(`No file at ${path}.`);
-    if (file2.size <= 0)
-      throw new Error(`${path} is empty; an attachment cannot be.`);
-    if (file2.size > MAX_ISSUE_ATTACHMENT_BYTES) {
-      throw new Error(`${path} is too large (${file2.size} bytes; max ${MAX_ISSUE_ATTACHMENT_BYTES}).`);
-    }
-  }
-  const created = new Set;
-  try {
-    for (const { path, file: file2 } of files) {
-      const uploadUrl = await client3.mutation(api2.issueAttachments.generateUploadUrl, { issueId });
-      const response = await fetch(uploadUrl, {
-        method: "POST",
-        headers: { "Content-Type": file2.type },
-        body: file2
-      });
-      if (!response.ok)
-        throw new Error(`Uploading ${path} failed (${response.status}).`);
-      const storageId = exports_external.custom((value) => typeof value === "string");
-      const body = exports_external.object({ storageId }).safeParse(await response.json());
-      if (!body.success)
-        throw new Error("The upload returned no file reference.");
-      created.add(await client3.action(api2.issueAttachments.create, {
-        issueId,
-        storageId: body.data.storageId,
-        name: basename(path)
-      }));
-    }
-  } catch (error51) {
-    for (const id of created) {
-      await client3.mutation(api2.issueAttachments.remove, { id }).catch(() => {
-        console.error("An attachment from this failed batch could not be removed; check the dashboard.");
-      });
-    }
-    throw error51;
+// src/lib/output.ts
+var printTable = (rows) => {
+  if (rows.length === 0)
+    return;
+  const columnCount = Math.max(...rows.map((row) => row.length));
+  const widths = Array.from({ length: columnCount }, (_, column) => Math.max(...rows.map((row) => (row[column] ?? "").length)));
+  for (const row of rows) {
+    console.log(row.map((cell, column) => cell.padEnd(widths[column] ?? 0)).join("  ").trimEnd());
   }
-  const attachments = await client3.query(api2.issueAttachments.list, { issueId });
-  return attachments.filter((attachment) => created.has(attachment._id));
 };
-var printAttachments = (attachments) => {
-  for (const attachment of attachments) {
-    console.log(`Attached ${attachment.name}${attachment.url ? ` \u2014 ${attachment.url}` : ""}`);
+
+// src/commands/inbox/list.ts
+var inboxOptions = {
+  all: exports_external.boolean().default(false).describe("Include events already marked seen"),
+  json: exports_external.boolean().default(false).describe("Print as JSON")
+};
+var runInbox = async (options) => {
+  const client3 = await backendClient();
+  const inbox = await client3.query(api2.inbox.list, {});
+  const targetLastSeen = new Map(inbox.targetLastSeen.map((state) => [state.targetId, state.lastSeenAt]));
+  const events = options.all ? inbox.events : inbox.events.filter((event) => {
+    const targetId = event.type === "issue" ? event.issue.id : event.project.id;
+    return event.at > Math.max(inbox.lastSeenAt, targetLastSeen.get(targetId) ?? 0);
+  });
+  if (options.json)
+    return console.log(JSON.stringify({ ...inbox, events }, null, 2));
+  if (events.length === 0) {
+    if (options.all)
+      console.log("Nothing in the inbox.");
+    else
+      console.log(inbox.truncated ? "Nothing unseen in the newest events shown." : "Inbox zero.");
+    if (!options.all && inbox.events.length > 0)
+      console.log("Pass --all to reprint seen events.");
+    return;
   }
+  printTable([
+    ["WHEN", "ACTOR", "WHERE", "EVENT"],
+    ...events.map((event) => [
+      new Date(event.at).toISOString().slice(0, 16).replace("T", " "),
+      actorLabel(event.via, event.agent),
+      event.type === "issue" ? event.issue.identifier : event.project.name,
+      event.type === "issue" ? issueActivityLine(event.detail) : projectActivityLine(event.detail)
+    ])
+  ]);
+  if (inbox.truncated)
+    console.log(`
+(older events truncated)`);
+  if (!options.all)
+    console.log("\nRun `kds inbox seen` once these are handled.");
 };
 
 // src/lib/input.ts
@@ -18011,6 +18146,83 @@ var resolveMilestone = async (client3, projectId, name) => {
   return milestone;
 };
 
+// src/commands/inbox/seen.ts
+var seen = command({
+  name: "seen",
+  description: "Mark one issue, or the whole inbox, as seen",
+  positionals: {
+    id: exports_external.string().optional().describe("Issue identifier, number, or URL")
+  },
+  run: async ({ positionals: { id } }) => {
+    const client3 = await backendClient();
+    const issue2 = id === undefined ? undefined : await resolveIssue(client3, id);
+    await client3.mutation(api2.inbox.markSeen, { targetId: issue2?._id });
+    console.log(issue2 ? `${issue2.identifier} marked seen.` : "Inbox marked seen.");
+  }
+});
+
+// src/commands/inbox/index.ts
+var inbox = group({
+  name: "inbox",
+  description: "Automated activity across issues and projects, unseen first",
+  options: inboxOptions,
+  run: async ({ options }) => await runInbox(options),
+  commands: [seen]
+});
+
+// src/lib/attachments.ts
+import { basename } from "path";
+var attachFiles = async (client3, issueId, paths) => {
+  if (paths.length === 0)
+    return [];
+  const files = paths.map((path) => ({ path, file: Bun.file(path) }));
+  for (const { path, file: file2 } of files) {
+    if (!await file2.exists())
+      throw new Error(`No file at ${path}.`);
+    if (file2.size <= 0)
+      throw new Error(`${path} is empty; an attachment cannot be.`);
+    if (file2.size > MAX_ISSUE_ATTACHMENT_BYTES) {
+      throw new Error(`${path} is too large (${file2.size} bytes; max ${MAX_ISSUE_ATTACHMENT_BYTES}).`);
+    }
+  }
+  const created = new Set;
+  try {
+    for (const { path, file: file2 } of files) {
+      const uploadUrl = await client3.mutation(api2.issueAttachments.generateUploadUrl, { issueId });
+      const response = await fetch(uploadUrl, {
+        method: "POST",
+        headers: { "Content-Type": file2.type },
+        body: file2
+      });
+      if (!response.ok)
+        throw new Error(`Uploading ${path} failed (${response.status}).`);
+      const storageId = exports_external.custom((value) => typeof value === "string");
+      const body = exports_external.object({ storageId }).safeParse(await response.json());
+      if (!body.success)
+        throw new Error("The upload returned no file reference.");
+      created.add(await client3.action(api2.issueAttachments.create, {
+        issueId,
+        storageId: body.data.storageId,
+        name: basename(path)
+      }));
+    }
+  } catch (error51) {
+    for (const id of created) {
+      await client3.mutation(api2.issueAttachments.remove, { id }).catch(() => {
+        console.error("An attachment from this failed batch could not be removed; check the dashboard.");
+      });
+    }
+    throw error51;
+  }
+  const attachments = await client3.query(api2.issueAttachments.list, { issueId });
+  return attachments.filter((attachment) => created.has(attachment._id));
+};
+var printAttachments = (attachments) => {
+  for (const attachment of attachments) {
+    console.log(`Attached ${attachment.name}${attachment.url ? ` \u2014 ${attachment.url}` : ""}`);
+  }
+};
+
 // src/commands/issues/comment.ts
 var comment = command({
   name: "comment",
@@ -18073,38 +18285,6 @@ var create = command({
 });
 
 // src/commands/issues/get.ts
-var SOURCE_LABELS = { github: "GitHub" };
-var activityLine = (detail) => {
-  const label = detail.kind.replaceAll("_", " ");
-  switch (detail.kind) {
-    case "created":
-    case "description_changed":
-      return label;
-    case "title_changed":
-    case "status_changed":
-    case "priority_changed":
-    case "disposition_changed":
-    case "estimate_changed":
-    case "due_date_changed":
-    case "branch_changed":
-    case "pr_changed":
-    case "project_changed":
-    case "milestone_changed":
-    case "parent_changed":
-      return `${label}: ${detail.from ?? "none"} \u2192 ${detail.to ?? "none"}`;
-    case "label_added":
-    case "label_removed":
-    case "attachment_added":
-    case "attachment_removed":
-      return `${label}: ${detail.name}`;
-    case "child_added":
-    case "child_removed":
-      return `${label}: ${detail.identifier}`;
-    case "relation_added":
-    case "relation_removed":
-      return `${label}: ${detail.relation.replaceAll("_", " ")} ${detail.identifier}`;
-  }
-};
 var get = command({
   name: "get",
   description: "Show an issue: properties, description, and its feed",
@@ -18172,8 +18352,8 @@ Feed:`);
     for (const event of feed.events) {
       const at = new Date(event.at).toISOString().slice(0, 16).replace("T", " ");
       if (event.type === "activity") {
-        const via = event.via === undefined ? "" : ` (via ${SOURCE_LABELS[event.via]})`;
-        console.log(`${at}  ${activityLine(event.detail)}${via}`);
+        const via = event.via === undefined ? "" : ` \u2014 ${actorLabel(event.via, event.agent)}`;
+        console.log(`${at}  ${issueActivityLine(event.detail)}${via}`);
       } else {
         console.log(`${at}  comment${event.editedAt ? " (edited)" : ""}:`);
         for (const line of event.bodyMarkdown.split(`
@@ -18184,17 +18364,6 @@ Feed:`);
   }
 });
 
-// src/lib/output.ts
-var printTable = (rows) => {
-  if (rows.length === 0)
-    return;
-  const columnCount = Math.max(...rows.map((row) => row.length));
-  const widths = Array.from({ length: columnCount }, (_, column) => Math.max(...rows.map((row) => (row[column] ?? "").length)));
-  for (const row of rows) {
-    console.log(row.map((cell, column) => cell.padEnd(widths[column] ?? 0)).join("  ").trimEnd());
-  }
-};
-
 // src/commands/issues/list.ts
 var list = command({
   name: "list",
@@ -18888,7 +19057,7 @@ var upgrade = command({
 var rootCommand = group({
   name: "kds",
   description: "KDS CLI",
-  commands: [auth, issues, pages, project, projects, upgrade],
+  commands: [auth, inbox, issues, pages, project, projects, upgrade],
   options: {
     version: exports_external.boolean().default(false).describe("Show the version").meta({ short: "v" })
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@islamihab/kds",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Command-line client for Kai Dev Studio",
   "license": "MIT",
   "publishConfig": {