@alpacakit/agents-conventions 0.1.0-beta.36 → 0.1.0-beta.39

package/dist/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../src/remove.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,KAAK,iBAAiB,EAAqB,MAAM,YAAY,CAAC;AAGvE,eAAO,MAAM,+BAA+B;;;;CAIlC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,eAAe,GAAG;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GACnC;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,+BAA+B,CAAC,cAAc,CAAC;IACrE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,+BAA+B,CAAC,kBAAkB,CAAC;IACzE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,+BAA+B,CAAC,QAAQ,CAAC;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD,iBAAiB,CAAC;AAEtB;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,2BAA2B,CAAC,CAyBtC"}

package/dist/remove.js

@@ -0,0 +1,73 @@
+/**
+ * The one way an agent leaves the shared home. `name` is a record name, the
+ * same position `connection login <name>` uses, and profiles win over agent
+ * configs because a profile is the more specific thing an operator names.
+ */
+import { rm } from "node:fs/promises";
+import { AUTH_MATERIAL_KIND } from "@alpacakit/agents";
+import { openAgentsHome } from "./home.js";
+import { rejectInvalidName } from "./names.js";
+import { createKeyringSecretRef, isManagedHomePath } from "./paths.js";
+export const REMOVE_AGENTS_HOME_ENTRY_RESULT = {
+    removedProfile: "removed_profile",
+    removedAgentConfig: "removed_agent_config",
+    notFound: "not_found",
+};
+/**
+ * The record goes first, then the credential it pointed at: if deleting the
+ * credential fails the operator is left with an inert directory or an orphaned
+ * keychain entry and a loud error — never with a live record pointing at a
+ * credential that is already gone.
+ *
+ * Only artifacts this package created are deleted. A home the operator pointed
+ * at themselves, or a secret behind someone else's resolver, is theirs.
+ */
+export async function removeAgentsHomeEntry(input) {
+    // Nothing this package created can carry a name outside the grammar, so a
+    // name outside it cannot match a record — and must never reach the delete.
+    const invalidName = rejectInvalidName(input.name);
+    if (invalidName !== null) {
+        return invalidName;
+    }
+    const home = openAgentsHome(input);
+    const profile = await home.config.profiles.remove(input.name);
+    if (profile !== null) {
+        return {
+            kind: REMOVE_AGENTS_HOME_ENTRY_RESULT.removedProfile,
+            profile,
+            removedManagedHome: await removeManagedHome(home.agentsHome, profile),
+            removedSecret: await removeManagedSecret(home.keyring, profile),
+        };
+    }
+    const agentConfig = await home.config.agentConfigs.remove(input.name);
+    if (agentConfig !== null) {
+        return {
+            kind: REMOVE_AGENTS_HOME_ENTRY_RESULT.removedAgentConfig,
+            agentConfig,
+        };
+    }
+    return { kind: REMOVE_AGENTS_HOME_ENTRY_RESULT.notFound, name: input.name };
+}
+async function removeManagedHome(agentsHome, profile) {
+    if (profile.material.kind !== AUTH_MATERIAL_KIND.homeDir) {
+        return null;
+    }
+    const { path } = profile.material;
+    if (!isManagedHomePath({ rootDir: agentsHome, profileId: profile.id, path })) {
+        return null;
+    }
+    await rm(path, { recursive: true, force: true });
+    return path;
+}
+async function removeManagedSecret(keyring, profile) {
+    if (profile.material.kind !== AUTH_MATERIAL_KIND.apiKey) {
+        return false;
+    }
+    const managed = createKeyringSecretRef(profile.id);
+    const { secret } = profile.material;
+    if (secret.resolver !== managed.resolver || secret.id !== managed.id) {
+        return false;
+    }
+    await keyring.delete(secret.id);
+    return true;
+}

package/dist/values.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The family vocabulary, spelled once. Every constant here is a decision
+ * about WHERE shared agent state lives on a machine — the one thing every
+ * AlpacaKit-family product must agree on to see the same agents.
+ */
+export declare const AGENTS_HOME_ENV_VAR = "ALPACA_AGENTS_HOME";
+export declare const AGENTS_HOME_DIRECTORY = ".alpaca/agents";
+/** Keychain service for agent credentials — distinct from integrations (I1). */
+export declare const AGENTS_KEYRING_SERVICE = "alpaca.agents";
+export declare const AGENTS_KEYRING_RESOLVER = "agents-home-keyring";
+/** Login homes this package creates, and is therefore allowed to delete. */
+export declare const AGENTS_MANAGED_HOMES_DIRECTORY = "managed-homes";
+export declare const AGENTS_KEYRING_ACCOUNT: {
+    readonly prefix: "profile";
+    readonly apiKeySuffix: "api-key";
+    readonly separator: ":";
+};
+/**
+ * Which agent kinds an operator can add to the shared home. Deciding this is
+ * the family's job, not a product's, so the vocabulary lives beside the
+ * procedure that acts on it — `./cli` only spells it as a flag.
+ *
+ * A literal, because `AGENT_CONFIG_KIND` values are branded and cannot be a
+ * CLI enum; a test pins the two together so they cannot drift.
+ */
+export declare const AGENT_ADD_KIND: {
+    readonly openaiCompatible: "openai-compatible";
+};
+export type AgentAddKind = (typeof AGENT_ADD_KIND)[keyof typeof AGENT_ADD_KIND];
+//# sourceMappingURL=values.d.ts.map

package/dist/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../src/values.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AACtD,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AACtD,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D,4EAA4E;AAC5E,eAAO,MAAM,8BAA8B,kBAAkB,CAAC;AAC9D,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;CAEjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC"}

package/dist/values.js

@@ -0,0 +1,28 @@
+/**
+ * The family vocabulary, spelled once. Every constant here is a decision
+ * about WHERE shared agent state lives on a machine — the one thing every
+ * AlpacaKit-family product must agree on to see the same agents.
+ */
+export const AGENTS_HOME_ENV_VAR = "ALPACA_AGENTS_HOME";
+export const AGENTS_HOME_DIRECTORY = ".alpaca/agents";
+/** Keychain service for agent credentials — distinct from integrations (I1). */
+export const AGENTS_KEYRING_SERVICE = "alpaca.agents";
+export const AGENTS_KEYRING_RESOLVER = "agents-home-keyring";
+/** Login homes this package creates, and is therefore allowed to delete. */
+export const AGENTS_MANAGED_HOMES_DIRECTORY = "managed-homes";
+export const AGENTS_KEYRING_ACCOUNT = {
+    prefix: "profile",
+    apiKeySuffix: "api-key",
+    separator: ":",
+};
+/**
+ * Which agent kinds an operator can add to the shared home. Deciding this is
+ * the family's job, not a product's, so the vocabulary lives beside the
+ * procedure that acts on it — `./cli` only spells it as a flag.
+ *
+ * A literal, because `AGENT_CONFIG_KIND` values are branded and cannot be a
+ * CLI enum; a test pins the two together so they cannot drift.
+ */
+export const AGENT_ADD_KIND = {
+    openaiCompatible: "openai-compatible",
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alpacakit/agents-conventions",
-  "version": "0.1.0-beta.36",
-  "description": "AlpacaKit-family conventions for @alpacakit/agents machine-local config (paths, keyring, managed homes).",
+  "version": "0.1.0-beta.39",
+  "description": "AlpacaKit-family conventions for @alpacakit/agents machine-local config (paths, keyring, managed homes) and the shared `agent` command surface.",
   "license": "MIT",
   "type": "module",
   "publishConfig": {
@@ -12,6 +12,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
     }
   },
   "types": "./dist/index.d.ts",
@@ -21,11 +25,18 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@alpacakit/agents": "0.1.0-beta.36"
+    "@alpacakit/agents": "0.1.0-beta.39",
+    "@alpacakit/core": "0.1.0-beta.39"
   },
   "devDependencies": {
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "vitest": "^4.0.18",
+    "zod": "4.3.6",
+    "@alpacakit/channels": "0.1.0-beta.39"
+  },
+  "peerDependencies": {
+    "zod": "^4.3.6",
+    "@alpacakit/channels": "^0.1.0-beta.39"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",