@alpacakit/agents-conventions 0.1.0-beta.19

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Masahiro Tonomura (codemafia0000)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,12 @@
+# @alpacakit/agents-conventions
+
+AlpacaLoop-family conventions for [`@alpacakit/agents`](../agents) machine-local
+config: the `ALPACA_AGENTS_HOME` / `~/.alpaca/agents` config root, the
+`alpacaloop.agents-home` keyring service, and the managed-home layout shared
+by AlpacaLoop-family products (the CLI, promptopt, codehint).
+
+This package is **internal and unpublished** (`private: true`). It is a plain
+consumer of the neutral `@alpacakit/agents` public API — the same shape any
+third party would write for their own convention. The general library ships a
+convention-neutral `@alpacakit/agents/config/xdg` preset; this is the
+AlpacaLoop-specific instance, kept out of the published OSS surface.

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * AlpacaLoop-family conventions for `@alpacakit/agents` machine-local
+ * config. This lives OUTSIDE the neutral `@alpacakit/agents` package on
+ * purpose: it encodes AlpacaLoop-specific paths, keyring service names, and
+ * the managed-home layout that no general OSS consumer needs. It builds on
+ * the agents package's PUBLIC API only, so it is a plain consumer — the
+ * same shape any third party would write for their own family convention.
+ *
+ * Not published (`private`): the public source doubles as the worked
+ * example, without adding org policy to the npm surface.
+ */
+import type { SecretRef } from "@alpacakit/agents";
+import type { OpenAgentsConfigOptions } from "@alpacakit/agents/config";
+export declare const ALPACA_LOOP_AGENTS_CONFIG_ENV_VAR = "ALPACA_AGENTS_HOME";
+export declare const ALPACA_LOOP_AGENTS_CONFIG_DIRECTORY = ".alpaca/agents";
+export declare const ALPACA_LOOP_AGENTS_CONFIG_KEYRING_SERVICE = "alpacaloop.agents-home";
+export declare const ALPACA_LOOP_AGENTS_CONFIG_KEYRING_RESOLVER = "agents-home-keyring";
+export type AgentsConfigOptionsInput = {
+    readonly homeDir: string;
+    readonly env: Readonly<Record<string, string | undefined>>;
+};
+export type ManagedHomePathInput = {
+    readonly rootDir: string;
+    readonly profileId: string;
+};
+export declare function resolveAgentsConfigOptions(input: AgentsConfigOptionsInput): OpenAgentsConfigOptions;
+export declare function createKeyringSecretRef(profileId: string): SecretRef;
+export declare function resolveManagedHomePath(input: ManagedHomePathInput): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAGlC,eAAO,MAAM,iCAAiC,uBAAuB,CAAC;AACtE,eAAO,MAAM,mCAAmC,mBAAmB,CAAC;AACpE,eAAO,MAAM,yCAAyC,2BAC5B,CAAC;AAC3B,eAAO,MAAM,0CAA0C,wBAAwB,CAAC;AAQhF,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,wBAAwB,GAC9B,uBAAuB,CAKzB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CASnE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAM1E"}

package/dist/index.js

@@ -0,0 +1,59 @@
+/**
+ * AlpacaLoop-family conventions for `@alpacakit/agents` machine-local
+ * config. This lives OUTSIDE the neutral `@alpacakit/agents` package on
+ * purpose: it encodes AlpacaLoop-specific paths, keyring service names, and
+ * the managed-home layout that no general OSS consumer needs. It builds on
+ * the agents package's PUBLIC API only, so it is a plain consumer — the
+ * same shape any third party would write for their own family convention.
+ *
+ * Not published (`private`): the public source doubles as the worked
+ * example, without adding org policy to the npm surface.
+ */
+import path from "node:path";
+import { keyringResolver } from "@alpacakit/agents/keyring";
+export const ALPACA_LOOP_AGENTS_CONFIG_ENV_VAR = "ALPACA_AGENTS_HOME";
+export const ALPACA_LOOP_AGENTS_CONFIG_DIRECTORY = ".alpaca/agents";
+export const ALPACA_LOOP_AGENTS_CONFIG_KEYRING_SERVICE = "alpacaloop.agents-home";
+export const ALPACA_LOOP_AGENTS_CONFIG_KEYRING_RESOLVER = "agents-home-keyring";
+const ALPACA_LOOP_AGENTS_CONFIG_MANAGED_HOMES_DIRECTORY = "managed-homes";
+const ALPACA_LOOP_AGENTS_CONFIG_KEYRING_ACCOUNT = {
+    prefix: "profile",
+    apiKeySuffix: "api-key",
+    separator: ":",
+};
+export function resolveAgentsConfigOptions(input) {
+    return {
+        rootDir: resolveAgentsConfigRootDir(input),
+        secretResolvers: [createKeyringResolverEntry()],
+    };
+}
+export function createKeyringSecretRef(profileId) {
+    return {
+        resolver: ALPACA_LOOP_AGENTS_CONFIG_KEYRING_RESOLVER,
+        id: [
+            ALPACA_LOOP_AGENTS_CONFIG_KEYRING_ACCOUNT.prefix,
+            profileId,
+            ALPACA_LOOP_AGENTS_CONFIG_KEYRING_ACCOUNT.apiKeySuffix,
+        ].join(ALPACA_LOOP_AGENTS_CONFIG_KEYRING_ACCOUNT.separator),
+    };
+}
+export function resolveManagedHomePath(input) {
+    return path.join(input.rootDir, ALPACA_LOOP_AGENTS_CONFIG_MANAGED_HOMES_DIRECTORY, input.profileId);
+}
+function resolveAgentsConfigRootDir(input) {
+    return (readNonBlankEnvValue(input.env, ALPACA_LOOP_AGENTS_CONFIG_ENV_VAR) ??
+        path.join(input.homeDir, ALPACA_LOOP_AGENTS_CONFIG_DIRECTORY));
+}
+function createKeyringResolverEntry() {
+    return {
+        name: ALPACA_LOOP_AGENTS_CONFIG_KEYRING_RESOLVER,
+        resolver: keyringResolver({
+            service: ALPACA_LOOP_AGENTS_CONFIG_KEYRING_SERVICE,
+        }),
+    };
+}
+/** Inlined from the agents package's internal env helper (not exported). */
+function readNonBlankEnvValue(env, name) {
+    const value = env[name];
+    return typeof value === "string" && value.trim().length > 0 ? value : null;
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@alpacakit/agents-conventions",
+  "version": "0.1.0-beta.19",
+  "description": "AlpacaKit-family conventions for @alpacakit/agents machine-local config (paths, keyring, managed homes).",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README*.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@alpacakit/agents": "0.1.0-beta.19"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}