@things-factory/ai-client-base 10.1.149 → 10.1.157

package/dist-server/service/agent/ai-usage.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiUsage = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const auth_base_1 = require("@things-factory/auth-base");
+const shell_1 = require("@things-factory/shell");
+/**
+ * One provider request - the metering boundary writes a row each time a model is called (ADR-0061 decision 6,
+ * design/ai/agent-settings.md §6).
+ *
+ * A turn that loops through tools makes several rows. The row is joined to a conversation by id only and is never
+ * copied onto a message. It is written once and never changed, so it has no updater.
+ */
+let AiUsage = class AiUsage {
+};
+exports.AiUsage = AiUsage;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { description: 'Row id.' }),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain, { nullable: true, description: 'The domain the call was made in.' }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], AiUsage.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((usage) => usage.domain),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)(type => String, { nullable: true, description: 'The agent that answered.' }),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "agentId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)(type => String, { nullable: true, description: 'The domain that declared the agent - a domain above when the agent was inherited.' }),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "agentDomainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)(type => String, { nullable: true, description: 'The domain whose API key answered - whose cost the call is.' }),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "keyDomainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(type => String, { description: 'openai, anthropic or gemini.' }),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "provider", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(type => String, { description: 'The model the provider reported answering.' }),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "model", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)(type => String, { nullable: true, description: 'The conversation mode kind, when the call was part of a conversation.' }),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "modeKind", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(type => String, { description: 'chat, chatWithTools, generateJSON or vision.' }),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "operation", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)(type => String, { nullable: true, description: 'The conversation the call belongs to, by id only.' }),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "sessionId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'int', nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'Input tokens the provider reported.' }),
+    tslib_1.__metadata("design:type", Number)
+], AiUsage.prototype, "inputTokens", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'int', nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'Output tokens the provider reported.' }),
+    tslib_1.__metadata("design:type", Number)
+], AiUsage.prototype, "outputTokens", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'int' }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'How long the request took, in milliseconds.' }),
+    tslib_1.__metadata("design:type", Number)
+], AiUsage.prototype, "durationMs", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(type => String, { description: 'ok, or why the request failed: key-rejected, rate-limited or provider-error.' }),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "outcome", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(type => Date, { description: 'The UTC hour the call started in.' }),
+    tslib_1.__metadata("design:type", Date)
+], AiUsage.prototype, "hourStart", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'The person who made the call. Empty for a call with no person, such as a webhook.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], AiUsage.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((usage) => usage.creator),
+    tslib_1.__metadata("design:type", String)
+], AiUsage.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)(type => Date, { description: 'When the call was made.' }),
+    tslib_1.__metadata("design:type", Date)
+], AiUsage.prototype, "createdAt", void 0);
+exports.AiUsage = AiUsage = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_ai_usage_0', (usage) => [usage.domain, usage.hourStart]),
+    (0, typeorm_1.Index)('ix_ai_usage_1', (usage) => [usage.agentDomainId, usage.hourStart]),
+    (0, type_graphql_1.ObjectType)({ description: 'One request an AI agent sent to its provider, with what it used.' })
+], AiUsage);
+//# sourceMappingURL=ai-usage.js.map

package/dist-server/service/agent/ai-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.js","sourceRoot":"","sources":["../../../server/service/agent/ai-usage.ts"],"names":[],"mappings":"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","sourcesContent":["import { Column, CreateDateColumn, Entity, Index, ManyToOne, PrimaryGeneratedColumn, RelationId } from 'typeorm'\nimport { Field, ID, Int, ObjectType } from 'type-graphql'\n\nimport { User } from '@things-factory/auth-base'\nimport { Domain } from '@things-factory/shell'\n\n/**\n * One provider request - the metering boundary writes a row each time a model is called (ADR-0061 decision 6,\n * design/ai/agent-settings.md §6).\n *\n * A turn that loops through tools makes several rows. The row is joined to a conversation by id only and is never\n * copied onto a message. It is written once and never changed, so it has no updater.\n */\n@Entity()\n@Index('ix_ai_usage_0', (usage: AiUsage) => [usage.domain, usage.hourStart])\n@Index('ix_ai_usage_1', (usage: AiUsage) => [usage.agentDomainId, usage.hourStart])\n@ObjectType({ description: 'One request an AI agent sent to its provider, with what it used.' })\nexport class AiUsage {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { description: 'Row id.' })\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'The domain the call was made in.' })\n  domain?: Domain\n\n  @RelationId((usage: AiUsage) => usage.domain)\n  domainId?: string\n\n  @Column({ nullable: true })\n  @Field(type => String, { nullable: true, description: 'The agent that answered.' })\n  agentId?: string\n\n  @Column({ nullable: true })\n  @Field(type => String, { nullable: true, description: 'The domain that declared the agent - a domain above when the agent was inherited.' })\n  agentDomainId?: string\n\n  @Column({ nullable: true })\n  @Field(type => String, { nullable: true, description: 'The domain whose API key answered - whose cost the call is.' })\n  keyDomainId?: string\n\n  @Column()\n  @Field(type => String, { description: 'openai, anthropic or gemini.' })\n  provider: string\n\n  @Column()\n  @Field(type => String, { description: 'The model the provider reported answering.' })\n  model: string\n\n  @Column({ nullable: true })\n  @Field(type => String, { nullable: true, description: 'The conversation mode kind, when the call was part of a conversation.' })\n  modeKind?: string\n\n  @Column()\n  @Field(type => String, { description: 'chat, chatWithTools, generateJSON or vision.' })\n  operation: string\n\n  @Column({ nullable: true })\n  @Field(type => String, { nullable: true, description: 'The conversation the call belongs to, by id only.' })\n  sessionId?: string\n\n  @Column({ type: 'int', nullable: true })\n  @Field(type => Int, { nullable: true, description: 'Input tokens the provider reported.' })\n  inputTokens?: number\n\n  @Column({ type: 'int', nullable: true })\n  @Field(type => Int, { nullable: true, description: 'Output tokens the provider reported.' })\n  outputTokens?: number\n\n  @Column({ type: 'int' })\n  @Field(type => Int, { description: 'How long the request took, in milliseconds.' })\n  durationMs: number\n\n  /** `ok`, or why it failed: key-rejected · rate-limited · provider-error. */\n  @Column()\n  @Field(type => String, { description: 'ok, or why the request failed: key-rejected, rate-limited or provider-error.' })\n  outcome: string\n\n  /**\n   * The UTC hour the call started in. Usage is grouped by this column, which every database can do; days and months\n   * are rolled up from it in the domain's time zone.\n   */\n  @Column()\n  @Field(type => Date, { description: 'The UTC hour the call started in.' })\n  hourStart: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'The person who made the call. Empty for a call with no person, such as a webhook.' })\n  creator?: User\n\n  @RelationId((usage: AiUsage) => usage.creator)\n  creatorId?: string\n\n  @CreateDateColumn()\n  @Field(type => Date, { description: 'When the call was made.' })\n  createdAt: Date\n}\n"]}

package/dist-server/service/agent/index.d.ts

@@ -0,0 +1,7 @@
+export * from './agent-spec.js';
+export * from './agent-directory.js';
+export * from './ai-client-for.js';
+export * from './provider-models.js';
+export * from './agent-settings-save.js';
+export * from './ai-usage-summary.js';
+export { AiUsage } from './ai-usage.js';

package/dist-server/service/agent/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiUsage = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./agent-spec.js"), exports);
+tslib_1.__exportStar(require("./agent-directory.js"), exports);
+tslib_1.__exportStar(require("./ai-client-for.js"), exports);
+tslib_1.__exportStar(require("./provider-models.js"), exports);
+tslib_1.__exportStar(require("./agent-settings-save.js"), exports);
+tslib_1.__exportStar(require("./ai-usage-summary.js"), exports);
+var ai_usage_js_1 = require("./ai-usage.js");
+Object.defineProperty(exports, "AiUsage", { enumerable: true, get: function () { return ai_usage_js_1.AiUsage; } });
+//# sourceMappingURL=index.js.map

package/dist-server/service/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/agent/index.ts"],"names":[],"mappings":";;;;AAAA,0DAA+B;AAC/B,+DAAoC;AACpC,6DAAkC;AAClC,+DAAoC;AACpC,mEAAwC;AACxC,gEAAqC;AACrC,6CAAuC;AAA9B,sGAAA,OAAO,OAAA","sourcesContent":["export * from './agent-spec.js'\nexport * from './agent-directory.js'\nexport * from './ai-client-for.js'\nexport * from './provider-models.js'\nexport * from './agent-settings-save.js'\nexport * from './ai-usage-summary.js'\nexport { AiUsage } from './ai-usage.js'\n"]}

package/dist-server/service/agent/provider-models.d.ts

@@ -0,0 +1,12 @@
+export interface ProviderModelsRequest {
+    provider: string;
+    apiKey: string;
+    baseURL?: string;
+    organization?: string;
+}
+/**
+ * The conversation models a key may call, read from the provider (design/ai/agent-settings.md §3-4). A model is only
+ * ever picked from this list. Reading it also proves the key: a refused key and an unreachable provider come back as
+ * reasons, never as an empty list.
+ */
+export declare function listProviderModels(request: ProviderModelsRequest): Promise<string[]>;

package/dist-server/service/agent/provider-models.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listProviderModels = listProviderModels;
+const shell_1 = require("@things-factory/shell");
+const factory_js_1 = require("../factory.js");
+const agent_spec_js_1 = require("./agent-spec.js");
+const ai_client_for_js_1 = require("./ai-client-for.js");
+/**
+ * The conversation models a key may call, read from the provider (design/ai/agent-settings.md §3-4). A model is only
+ * ever picked from this list. Reading it also proves the key: a refused key and an unreachable provider come back as
+ * reasons, never as an empty list.
+ */
+async function listProviderModels(request) {
+    if (!(0, agent_spec_js_1.isAiAgentProvider)(request.provider)) {
+        throw new shell_1.Refusal('ai-agent-provider-unknown', { provider: request.provider }, `"${request.provider}" is not a provider an agent can use.`);
+    }
+    if (!request.apiKey?.trim()) {
+        throw new shell_1.Refusal('ai-agent-key-required', {}, 'Enter the API key first.');
+    }
+    const client = (0, factory_js_1.createAIClient)({
+        provider: request.provider,
+        apiKey: request.apiKey.trim(),
+        ...(request.baseURL && { baseURL: request.baseURL }),
+        ...(request.organization && { organization: request.organization })
+    });
+    try {
+        return await client.listModels();
+    }
+    catch (error) {
+        /* Gemini answers a wrong key with 400 ("API key not valid"); a list request has no other input to be wrong. */
+        if ((0, ai_client_for_js_1.outcomeOf)(error) === 'key-rejected' || Number(error?.status) === 400) {
+            throw new shell_1.Refusal('ai-provider-key-rejected', { provider: request.provider }, 'The provider did not accept this API key.');
+        }
+        throw new shell_1.Refusal('ai-provider-unreachable', { provider: request.provider }, 'The provider could not be reached.');
+    }
+}
+//# sourceMappingURL=provider-models.js.map

package/dist-server/service/agent/provider-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-models.js","sourceRoot":"","sources":["../../../server/service/agent/provider-models.ts"],"names":[],"mappings":";;AAkBA,gDAwBC;AA1CD,iDAA+C;AAE/C,8CAA8C;AAC9C,mDAAyE;AACzE,yDAA8C;AAS9C;;;;GAIG;AACI,KAAK,UAAU,kBAAkB,CAAC,OAA8B;IACrE,IAAI,CAAC,IAAA,iCAAiB,EAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,eAAO,CAAC,2BAA2B,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,OAAO,CAAC,QAAQ,uCAAuC,CAAC,CAAA;IAC7I,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,eAAO,CAAC,uBAAuB,EAAE,EAAE,EAAE,0BAA0B,CAAC,CAAA;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,2BAAc,EAAC;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAA2B;QAC7C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE;QAC7B,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACpD,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;KACpE,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,UAAU,EAAE,CAAA;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+GAA+G;QAC/G,IAAI,IAAA,4BAAS,EAAC,KAAK,CAAC,KAAK,cAAc,IAAI,MAAM,CAAE,KAAa,EAAE,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC;YAClF,MAAM,IAAI,eAAO,CAAC,0BAA0B,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,2CAA2C,CAAC,CAAA;QAC5H,CAAC;QACD,MAAM,IAAI,eAAO,CAAC,yBAAyB,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,oCAAoC,CAAC,CAAA;IACpH,CAAC;AACH,CAAC","sourcesContent":["import { Refusal } from '@things-factory/shell'\n\nimport { createAIClient } from '../factory.js'\nimport { type AiAgentProvider, isAiAgentProvider } from './agent-spec.js'\nimport { outcomeOf } from './ai-client-for.js'\n\nexport interface ProviderModelsRequest {\n  provider: string\n  apiKey: string\n  baseURL?: string\n  organization?: string\n}\n\n/**\n * The conversation models a key may call, read from the provider (design/ai/agent-settings.md §3-4). A model is only\n * ever picked from this list. Reading it also proves the key: a refused key and an unreachable provider come back as\n * reasons, never as an empty list.\n */\nexport async function listProviderModels(request: ProviderModelsRequest): Promise<string[]> {\n  if (!isAiAgentProvider(request.provider)) {\n    throw new Refusal('ai-agent-provider-unknown', { provider: request.provider }, `\"${request.provider}\" is not a provider an agent can use.`)\n  }\n  if (!request.apiKey?.trim()) {\n    throw new Refusal('ai-agent-key-required', {}, 'Enter the API key first.')\n  }\n\n  const client = createAIClient({\n    provider: request.provider as AiAgentProvider,\n    apiKey: request.apiKey.trim(),\n    ...(request.baseURL && { baseURL: request.baseURL }),\n    ...(request.organization && { organization: request.organization })\n  })\n\n  try {\n    return await client.listModels()\n  } catch (error) {\n    /* Gemini answers a wrong key with 400 (\"API key not valid\"); a list request has no other input to be wrong. */\n    if (outcomeOf(error) === 'key-rejected' || Number((error as any)?.status) === 400) {\n      throw new Refusal('ai-provider-key-rejected', { provider: request.provider }, 'The provider did not accept this API key.')\n    }\n    throw new Refusal('ai-provider-unreachable', { provider: request.provider }, 'The provider could not be reached.')\n  }\n}\n"]}

package/dist-server/service/capability.d.ts

@@ -1,17 +1,28 @@
+/**
+ * Is there an AI for this domain, and what is missing — asked before anything is tried.
+ *
+ * The twin had a button that asked the assistant, and whether to show it was decided by whether a
+ * now-dead mutation had failed once. When the dock moved to the neutral door nothing called that
+ * mutation any more, so the answer was "configured" forever: the button appeared on deployments
+ * with no provider at all and failed when pressed (standard A7-a).
+ *
+ * A capability is read, not discovered by failing (ADR-0042 decision ②). It lives here because the
+ * agents do, and the answer has three states — the third is the one a screen must not fold away:
+ * **not asked yet** is not "configured". Since agents are set per domain (design/ai/agent-settings.md),
+ * so is the answer.
+ */
+import type { Domain } from '@things-factory/shell';
+import { type AiAgentDirectory } from './agent/agent-directory.js';
 export type AiCapabilityState = 'configured' | 'not-configured';
 export interface AiCapability {
     state: AiCapabilityState;
-    /** Which provider answers, when one does — for the person reading a boot log, not for a screen. */
+    /** The provider of the agent a request without a choice gets. */
     provider?: string;
-    /** The default model this deployment would use. */
+    /** That agent's model. */
     model?: string;
-    /** Why it is not configured, as a code: no-config · no-provider · unknown-provider · no-adapter · no-api-key. */
+    /** Why it is not configured, as a code: no-agent · no-agent-key · no-usable-agent. */
     reason?: string;
 }
-/**
- * What this server can do, as of now.
- *
- * Creating the client is what proves a provider adapter is loaded and the configuration parses, so
- * this asks for it. It never throws: a deployment with no AI is a normal deployment.
- */
-export declare function aiCapability(): AiCapability;
+/** What this domain can do, as of now. It never throws: a domain with no AI is a normal domain. */
+export declare function aiCapability(domain: Domain): Promise<AiCapability>;
+export declare function capabilityOf(directory: Pick<AiAgentDirectory, 'entries' | 'defaultAgentId'>): AiCapability;

package/dist-server/service/capability.js

@@ -1,57 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.aiCapability = aiCapability;
-/**
- * Is there an AI on this deployment, and what is missing — asked before anything is tried.
- *
- * The twin had a button that asked the assistant, and whether to show it was decided by whether a
- * now-dead mutation had failed once. When the dock moved to the neutral door nothing called that
- * mutation any more, so the answer was "configured" forever: the button appeared on deployments
- * with no provider at all and failed when pressed (standard A7-a).
- *
- * A capability is read, not discovered by failing (ADR-0042 decision ②). It lives here because the
- * provider configuration does, and the answer has three states — the third is the one a screen
- * must not fold away: **not asked yet** is not "configured".
- */
-const env_1 = require("@things-factory/env");
-const factory_js_1 = require("./factory.js");
-/**
- * What this server can do, as of now.
- *
- * Creating the client is what proves a provider adapter is loaded and the configuration parses, so
- * this asks for it. It never throws: a deployment with no AI is a normal deployment.
- */
-function aiCapability() {
-    const cfg = env_1.config.get('aiClient', null);
-    const client = safeDefaultClient();
-    if (client) {
-        const [provider, model] = String(client.id ?? '').split(':');
-        /*
-          A configuration that has a key slot and nothing in it - `apiKey: process.env.X` with X unset - still builds a
-          client, and every request then fails at the provider. The dock offered a chat that could only answer "something
-          went wrong" (operato-figure with no .env, 2026-09-25). No key is not configured.
-        */
-        if (cfg && 'apiKey' in cfg && !String(cfg.apiKey ?? '').trim()) {
-            return { state: 'not-configured', provider: provider || cfg.provider, model: model || cfg.model, reason: 'no-api-key' };
-        }
-        return { state: 'configured', provider: provider || undefined, model: model || undefined };
-    }
-    if (!cfg)
-        return { state: 'not-configured', reason: 'no-config' };
-    if (!cfg.provider)
-        return { state: 'not-configured', reason: 'no-provider' };
-    if (!(0, factory_js_1.listRegisteredProviders)().includes(cfg.provider)) {
-        return { state: 'not-configured', provider: cfg.provider, reason: 'unknown-provider' };
-    }
-    return { state: 'not-configured', provider: cfg.provider, model: cfg.model, reason: 'no-adapter' };
-}
-function safeDefaultClient() {
+exports.capabilityOf = capabilityOf;
+const agent_directory_js_1 = require("./agent/agent-directory.js");
+const ai_client_for_js_1 = require("./agent/ai-client-for.js");
+/** What this domain can do, as of now. It never throws: a domain with no AI is a normal domain. */
+async function aiCapability(domain) {
+    if ((0, ai_client_for_js_1.isAIClientForTesting)())
+        return { state: 'configured' };
     try {
-        return (0, factory_js_1.getDefaultAIClient)();
+        return capabilityOf(await (0, agent_directory_js_1.readAiAgentDirectory)(domain));
     }
-    catch {
-        /* A broken configuration is "not configured", and it is the reason below that says which. */
-        return undefined;
+    catch (error) {
+        console.error('[ai-client-base] could not read the AI agents of a domain:', error?.message);
+        return { state: 'not-configured', reason: 'no-agent' };
     }
 }
+function capabilityOf(directory) {
+    const chosen = directory.entries.find(one => one.spec.id === directory.defaultAgentId && one.usable);
+    if (chosen)
+        return { state: 'configured', provider: chosen.spec.provider, model: chosen.spec.model };
+    const live = directory.entries.filter(one => one.spec.active && !one.turnedOff);
+    if (!live.length)
+        return { state: 'not-configured', reason: directory.entries.length ? 'no-usable-agent' : 'no-agent' };
+    return { state: 'not-configured', reason: 'no-agent-key' };
+}
 //# sourceMappingURL=capability.js.map

package/dist-server/service/capability.js.map

@@ -1 +1 @@
-{"version":3,"file":"capability.js","sourceRoot":"","sources":["../../server/service/capability.ts"],"names":[],"mappings":";;AAkCA,oCAsBC;AAxDD;;;;;;;;;;;GAWG;AACH,6CAAyD;AAEzD,6CAA0E;AAc1E;;;;;GAKG;AACH,SAAgB,YAAY;IAC1B,MAAM,GAAG,GAAG,YAAS,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAmE,CAAA;IAC7G,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAClC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC5D;;;;UAIE;QACF,IAAI,GAAG,IAAI,QAAQ,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/D,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAA;QACzH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,IAAI,SAAS,EAAE,KAAK,EAAE,KAAK,IAAI,SAAS,EAAE,CAAA;IAC5F,CAAC;IAED,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;IACjE,IAAI,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,CAAA;IAC5E,IAAI,CAAC,IAAA,oCAAuB,GAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAA;IACxF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAA;AACpG,CAAC;AAED,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,OAAO,IAAA,+BAAkB,GAAE,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,6FAA6F;QAC7F,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC","sourcesContent":["/**\n * Is there an AI on this deployment, and what is missing — asked before anything is tried.\n *\n * The twin had a button that asked the assistant, and whether to show it was decided by whether a\n * now-dead mutation had failed once. When the dock moved to the neutral door nothing called that\n * mutation any more, so the answer was \"configured\" forever: the button appeared on deployments\n * with no provider at all and failed when pressed (standard A7-a).\n *\n * A capability is read, not discovered by failing (ADR-0042 decision ②). It lives here because the\n * provider configuration does, and the answer has three states — the third is the one a screen\n * must not fold away: **not asked yet** is not \"configured\".\n */\nimport { config as envConfig } from '@things-factory/env'\n\nimport { getDefaultAIClient, listRegisteredProviders } from './factory.js'\n\nexport type AiCapabilityState = 'configured' | 'not-configured'\n\nexport interface AiCapability {\n  state: AiCapabilityState\n  /** Which provider answers, when one does — for the person reading a boot log, not for a screen. */\n  provider?: string\n  /** The default model this deployment would use. */\n  model?: string\n  /** Why it is not configured, as a code: no-config · no-provider · unknown-provider · no-adapter · no-api-key. */\n  reason?: string\n}\n\n/**\n * What this server can do, as of now.\n *\n * Creating the client is what proves a provider adapter is loaded and the configuration parses, so\n * this asks for it. It never throws: a deployment with no AI is a normal deployment.\n */\nexport function aiCapability(): AiCapability {\n  const cfg = envConfig.get('aiClient', null) as { provider?: string; model?: string; apiKey?: unknown } | null\n  const client = safeDefaultClient()\n  if (client) {\n    const [provider, model] = String(client.id ?? '').split(':')\n    /*\n      A configuration that has a key slot and nothing in it - `apiKey: process.env.X` with X unset - still builds a\n      client, and every request then fails at the provider. The dock offered a chat that could only answer \"something\n      went wrong\" (operato-figure with no .env, 2026-09-25). No key is not configured.\n    */\n    if (cfg && 'apiKey' in cfg && !String(cfg.apiKey ?? '').trim()) {\n      return { state: 'not-configured', provider: provider || cfg.provider, model: model || cfg.model, reason: 'no-api-key' }\n    }\n    return { state: 'configured', provider: provider || undefined, model: model || undefined }\n  }\n\n  if (!cfg) return { state: 'not-configured', reason: 'no-config' }\n  if (!cfg.provider) return { state: 'not-configured', reason: 'no-provider' }\n  if (!listRegisteredProviders().includes(cfg.provider)) {\n    return { state: 'not-configured', provider: cfg.provider, reason: 'unknown-provider' }\n  }\n  return { state: 'not-configured', provider: cfg.provider, model: cfg.model, reason: 'no-adapter' }\n}\n\nfunction safeDefaultClient() {\n  try {\n    return getDefaultAIClient()\n  } catch {\n    /* A broken configuration is \"not configured\", and it is the reason below that says which. */\n    return undefined\n  }\n}\n"]}
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../../server/service/capability.ts"],"names":[],"mappings":";;AA+BA,oCAQC;AAED,oCAOC;AAjCD,mEAAwF;AACxF,+DAA+D;AAc/D,mGAAmG;AAC5F,KAAK,UAAU,YAAY,CAAC,MAAc;IAC/C,IAAI,IAAA,uCAAoB,GAAE;QAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;IAC1D,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,MAAM,IAAA,yCAAoB,EAAC,MAAM,CAAC,CAAC,CAAA;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4DAA4D,EAAG,KAAe,EAAE,OAAO,CAAC,CAAA;QACtG,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;IACxD,CAAC;AACH,CAAC;AAED,SAAgB,YAAY,CAAC,SAA+D;IAC1F,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,cAAc,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;IACpG,IAAI,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IAEpG,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAC/E,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU,EAAE,CAAA;IACvH,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;AAC5D,CAAC","sourcesContent":["/**\n * Is there an AI for this domain, and what is missing — asked before anything is tried.\n *\n * The twin had a button that asked the assistant, and whether to show it was decided by whether a\n * now-dead mutation had failed once. When the dock moved to the neutral door nothing called that\n * mutation any more, so the answer was \"configured\" forever: the button appeared on deployments\n * with no provider at all and failed when pressed (standard A7-a).\n *\n * A capability is read, not discovered by failing (ADR-0042 decision ②). It lives here because the\n * agents do, and the answer has three states — the third is the one a screen must not fold away:\n * **not asked yet** is not \"configured\". Since agents are set per domain (design/ai/agent-settings.md),\n * so is the answer.\n */\nimport type { Domain } from '@things-factory/shell'\n\nimport { type AiAgentDirectory, readAiAgentDirectory } from './agent/agent-directory.js'\nimport { isAIClientForTesting } from './agent/ai-client-for.js'\n\nexport type AiCapabilityState = 'configured' | 'not-configured'\n\nexport interface AiCapability {\n  state: AiCapabilityState\n  /** The provider of the agent a request without a choice gets. */\n  provider?: string\n  /** That agent's model. */\n  model?: string\n  /** Why it is not configured, as a code: no-agent · no-agent-key · no-usable-agent. */\n  reason?: string\n}\n\n/** What this domain can do, as of now. It never throws: a domain with no AI is a normal domain. */\nexport async function aiCapability(domain: Domain): Promise<AiCapability> {\n  if (isAIClientForTesting()) return { state: 'configured' }\n  try {\n    return capabilityOf(await readAiAgentDirectory(domain))\n  } catch (error) {\n    console.error('[ai-client-base] could not read the AI agents of a domain:', (error as Error)?.message)\n    return { state: 'not-configured', reason: 'no-agent' }\n  }\n}\n\nexport function capabilityOf(directory: Pick<AiAgentDirectory, 'entries' | 'defaultAgentId'>): AiCapability {\n  const chosen = directory.entries.find(one => one.spec.id === directory.defaultAgentId && one.usable)\n  if (chosen) return { state: 'configured', provider: chosen.spec.provider, model: chosen.spec.model }\n\n  const live = directory.entries.filter(one => one.spec.active && !one.turnedOff)\n  if (!live.length) return { state: 'not-configured', reason: directory.entries.length ? 'no-usable-agent' : 'no-agent' }\n  return { state: 'not-configured', reason: 'no-agent-key' }\n}\n"]}

package/dist-server/service/factory.d.ts

@@ -1,16 +1,11 @@
+/**
+ * Provider registration and client construction.
+ *
+ * Each adapter registers itself when its module loads. `createAIClient` builds a client from a provider, model and
+ * key; it is how this package's own door (aiClientFor) and the model list reach a provider. Code outside this package
+ * gets a client from aiClientFor, for a domain - there is no deployment-wide client.
+ */
 import type { AIClient, AIClientConfig, AIProviderFactory } from './types.js';
 export declare function registerAIProvider(name: string, factory: AIProviderFactory): void;
 export declare function listRegisteredProviders(): string[];
 export declare function createAIClient(config: AIClientConfig): AIClient;
-/**
- * 기본 client.
- *  1) `setDefaultAIClient()` 로 명시 설정된 게 있으면 그것
- *  2) env config 의 `aiClient` 키가 있으면 거기서 생성
- *  3) 없으면 undefined (호출자는 nullable 처리)
- *
- * 다른 모듈 (예: codelingua) 의 `openai` 키와는 의도적으로 분리. 두 키는 서로 모르고 동작.
- *
- * 잘못된 config (provider 누락, 등록되지 않은 provider) 는 console.warn 후 undefined.
- */
-export declare function getDefaultAIClient(): AIClient | undefined;
-export declare function setDefaultAIClient(client: AIClient | undefined): void;

package/dist-server/service/factory.js

@@ -3,16 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerAIProvider = registerAIProvider;
 exports.listRegisteredProviders = listRegisteredProviders;
 exports.createAIClient = createAIClient;
-exports.getDefaultAIClient = getDefaultAIClient;
-exports.setDefaultAIClient = setDefaultAIClient;
-/**
- * AI Provider 등록 + Client 생성.
- *
- * - 어댑터 패키지(또는 동일 패키지의 providers/) 가 모듈 로드 시 `registerAIProvider` 호출.
- * - 호출자는 `createAIClient({ provider: 'anthropic', ... })` 로 인스턴스 획득.
- * - things-factory env config 의 `aiClient` 키가 있으면 `getDefaultAIClient()` 가 자동 생성.
- */
-const env_1 = require("@things-factory/env");
 const REGISTERED_PROVIDERS = new Map();
 function registerAIProvider(name, factory) {
     REGISTERED_PROVIDERS.set(name, factory);
@@ -27,39 +17,4 @@ function createAIClient(config) {
     }
     return factory(config);
 }
-let _defaultClient;
-/**
- * 기본 client.
- *  1) `setDefaultAIClient()` 로 명시 설정된 게 있으면 그것
- *  2) env config 의 `aiClient` 키가 있으면 거기서 생성
- *  3) 없으면 undefined (호출자는 nullable 처리)
- *
- * 다른 모듈 (예: codelingua) 의 `openai` 키와는 의도적으로 분리. 두 키는 서로 모르고 동작.
- *
- * 잘못된 config (provider 누락, 등록되지 않은 provider) 는 console.warn 후 undefined.
- */
-function getDefaultAIClient() {
-    if (_defaultClient)
-        return _defaultClient;
-    const cfg = env_1.config.get('aiClient', null);
-    if (!cfg)
-        return undefined;
-    if (!cfg.provider) {
-        console.warn('[ai-client-base] config.aiClient is set but missing required "provider" field. ' +
-            'See @things-factory/ai-client-base/config/config.development.js for examples.');
-        return undefined;
-    }
-    try {
-        _defaultClient = createAIClient(cfg);
-    }
-    catch (e) {
-        console.warn(`[ai-client-base] Failed to create default AI client: ${e.message}. ` +
-            `Registered providers: ${listRegisteredProviders().join(', ') || '(none)'}`);
-        return undefined;
-    }
-    return _defaultClient;
-}
-function setDefaultAIClient(client) {
-    _defaultClient = client;
-}
 //# sourceMappingURL=factory.js.map

package/dist-server/service/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../server/service/factory.ts"],"names":[],"mappings":";;AAYA,gDAEC;AAED,0DAEC;AAED,wCAQC;AAcD,gDAqBC;AAED,gDAEC;AAnED;;;;;;GAMG;AACH,6CAAyD;AAGzD,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAA6B,CAAA;AAEjE,SAAgB,kBAAkB,CAAC,IAAY,EAAE,OAA0B;IACzE,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACzC,CAAC;AAED,SAAgB,uBAAuB;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAA;AAChD,CAAC;AAED,SAAgB,cAAc,CAAC,MAAsB;IACnD,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,wBAAwB,MAAM,CAAC,QAAQ,kBAAkB,uBAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAC5G,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAA;AACxB,CAAC;AAED,IAAI,cAAoC,CAAA;AAExC;;;;;;;;;GASG;AACH,SAAgB,kBAAkB;IAChC,IAAI,cAAc;QAAE,OAAO,cAAc,CAAA;IACzC,MAAM,GAAG,GAAG,YAAS,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAA0B,CAAA;IACpE,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CACV,iFAAiF;YAC/E,+EAA+E,CAClF,CAAA;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,CAAC;QACH,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;IACtC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CACV,wDAAyD,CAAW,CAAC,OAAO,IAAI;YAC9E,yBAAyB,uBAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAC9E,CAAA;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAA4B;IAC7D,cAAc,GAAG,MAAM,CAAA;AACzB,CAAC","sourcesContent":["/**\n * AI Provider 등록 + Client 생성.\n *\n * - 어댑터 패키지(또는 동일 패키지의 providers/) 가 모듈 로드 시 `registerAIProvider` 호출.\n * - 호출자는 `createAIClient({ provider: 'anthropic', ... })` 로 인스턴스 획득.\n * - things-factory env config 의 `aiClient` 키가 있으면 `getDefaultAIClient()` 가 자동 생성.\n */\nimport { config as envConfig } from '@things-factory/env'\nimport type { AIClient, AIClientConfig, AIProviderFactory } from './types.js'\n\nconst REGISTERED_PROVIDERS = new Map<string, AIProviderFactory>()\n\nexport function registerAIProvider(name: string, factory: AIProviderFactory): void {\n  REGISTERED_PROVIDERS.set(name, factory)\n}\n\nexport function listRegisteredProviders(): string[] {\n  return Array.from(REGISTERED_PROVIDERS.keys())\n}\n\nexport function createAIClient(config: AIClientConfig): AIClient {\n  const factory = REGISTERED_PROVIDERS.get(config.provider)\n  if (!factory) {\n    throw new Error(\n      `Unknown AI provider \"${config.provider}\". Registered: ${listRegisteredProviders().join(', ') || '(none)'}`\n    )\n  }\n  return factory(config)\n}\n\nlet _defaultClient: AIClient | undefined\n\n/**\n * 기본 client.\n *  1) `setDefaultAIClient()` 로 명시 설정된 게 있으면 그것\n *  2) env config 의 `aiClient` 키가 있으면 거기서 생성\n *  3) 없으면 undefined (호출자는 nullable 처리)\n *\n * 다른 모듈 (예: codelingua) 의 `openai` 키와는 의도적으로 분리. 두 키는 서로 모르고 동작.\n *\n * 잘못된 config (provider 누락, 등록되지 않은 provider) 는 console.warn 후 undefined.\n */\nexport function getDefaultAIClient(): AIClient | undefined {\n  if (_defaultClient) return _defaultClient\n  const cfg = envConfig.get('aiClient', null) as AIClientConfig | null\n  if (!cfg) return undefined\n  if (!cfg.provider) {\n    console.warn(\n      '[ai-client-base] config.aiClient is set but missing required \"provider\" field. ' +\n        'See @things-factory/ai-client-base/config/config.development.js for examples.'\n    )\n    return undefined\n  }\n  try {\n    _defaultClient = createAIClient(cfg)\n  } catch (e) {\n    console.warn(\n      `[ai-client-base] Failed to create default AI client: ${(e as Error).message}. ` +\n        `Registered providers: ${listRegisteredProviders().join(', ') || '(none)'}`\n    )\n    return undefined\n  }\n  return _defaultClient\n}\n\nexport function setDefaultAIClient(client: AIClient | undefined): void {\n  _defaultClient = client\n}\n"]}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../server/service/factory.ts"],"names":[],"mappings":";;AAWA,gDAEC;AAED,0DAEC;AAED,wCAQC;AAlBD,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAA6B,CAAA;AAEjE,SAAgB,kBAAkB,CAAC,IAAY,EAAE,OAA0B;IACzE,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACzC,CAAC;AAED,SAAgB,uBAAuB;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAA;AAChD,CAAC;AAED,SAAgB,cAAc,CAAC,MAAsB;IACnD,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,wBAAwB,MAAM,CAAC,QAAQ,kBAAkB,uBAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAC5G,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAA;AACxB,CAAC","sourcesContent":["/**\n * Provider registration and client construction.\n *\n * Each adapter registers itself when its module loads. `createAIClient` builds a client from a provider, model and\n * key; it is how this package's own door (aiClientFor) and the model list reach a provider. Code outside this package\n * gets a client from aiClientFor, for a domain - there is no deployment-wide client.\n */\nimport type { AIClient, AIClientConfig, AIProviderFactory } from './types.js'\n\nconst REGISTERED_PROVIDERS = new Map<string, AIProviderFactory>()\n\nexport function registerAIProvider(name: string, factory: AIProviderFactory): void {\n  REGISTERED_PROVIDERS.set(name, factory)\n}\n\nexport function listRegisteredProviders(): string[] {\n  return Array.from(REGISTERED_PROVIDERS.keys())\n}\n\nexport function createAIClient(config: AIClientConfig): AIClient {\n  const factory = REGISTERED_PROVIDERS.get(config.provider)\n  if (!factory) {\n    throw new Error(\n      `Unknown AI provider \"${config.provider}\". Registered: ${listRegisteredProviders().join(', ') || '(none)'}`\n    )\n  }\n  return factory(config)\n}\n"]}

package/dist-server/service/index.d.ts

@@ -8,4 +8,7 @@ export * from './assistant/index.js';
 export * from './analysis-contract.js';
 export * from './decision/index.js';
 export * from './capability.js';
+export * from './agent/index.js';
+import { AiUsage } from './agent/ai-usage.js';
+export declare const entities: (typeof AiUsage)[];
 export * from './testing/tool-call-context.js';

package/dist-server/service/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.entities = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./types.js"), exports);
 tslib_1.__exportStar(require("./factory.js"), exports);
@@ -10,7 +11,11 @@ tslib_1.__exportStar(require("./agentic-loop/index.js"), exports);
 tslib_1.__exportStar(require("./assistant/index.js"), exports);
 tslib_1.__exportStar(require("./analysis-contract.js"), exports);
 tslib_1.__exportStar(require("./decision/index.js"), exports);
-/* 「이 배포에 AI 가 있나」 — 시도해서 알아내지 않고 먼저 읽는다(표준 A7-a). */
+/* 「이 사업장에 AI 가 있나」 — 시도해서 알아내지 않고 먼저 읽는다(표준 A7-a). */
 tslib_1.__exportStar(require("./capability.js"), exports);
+/* AI agents per domain - the one door to a model, and its usage (design/ai/agent-settings.md). */
+tslib_1.__exportStar(require("./agent/index.js"), exports);
+const ai_usage_js_1 = require("./agent/ai-usage.js");
+exports.entities = [ai_usage_js_1.AiUsage];
 tslib_1.__exportStar(require("./testing/tool-call-context.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist-server/service/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;AAAA,qDAA0B;AAC1B,uDAA4B;AAC5B,+DAAoC;AACpC,2DAAgC;AAChC,mEAAwC;AACxC,kEAAuC;AACvC,+DAAoC;AACpC,iEAAsC;AACtC,8DAAmC;AACnC,qDAAqD;AACrD,0DAA+B;AAC/B,yEAA8C","sourcesContent":["export * from './types.js'\nexport * from './factory.js'\nexport * from './providers/index.js'\nexport * from './utils/index.js'\nexport * from './tool-registry/index.js'\nexport * from './agentic-loop/index.js'\nexport * from './assistant/index.js'\nexport * from './analysis-contract.js'\nexport * from './decision/index.js'\n/* 「이 배포에 AI 가 있나」 — 시도해서 알아내지 않고 먼저 읽는다(표준 A7-a). */\nexport * from './capability.js'\nexport * from './testing/tool-call-context.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;AAAA,qDAA0B;AAC1B,uDAA4B;AAC5B,+DAAoC;AACpC,2DAAgC;AAChC,mEAAwC;AACxC,kEAAuC;AACvC,+DAAoC;AACpC,iEAAsC;AACtC,8DAAmC;AACnC,sDAAsD;AACtD,0DAA+B;AAC/B,kGAAkG;AAClG,2DAAgC;AAEhC,qDAA6C;AAChC,QAAA,QAAQ,GAAG,CAAC,qBAAO,CAAC,CAAA;AACjC,yEAA8C","sourcesContent":["export * from './types.js'\nexport * from './factory.js'\nexport * from './providers/index.js'\nexport * from './utils/index.js'\nexport * from './tool-registry/index.js'\nexport * from './agentic-loop/index.js'\nexport * from './assistant/index.js'\nexport * from './analysis-contract.js'\nexport * from './decision/index.js'\n/* 「이 사업장에 AI 가 있나」 — 시도해서 알아내지 않고 먼저 읽는다(표준 A7-a). */\nexport * from './capability.js'\n/* AI agents per domain - the one door to a model, and its usage (design/ai/agent-settings.md). */\nexport * from './agent/index.js'\n\nimport { AiUsage } from './agent/ai-usage.js'\nexport const entities = [AiUsage]\nexport * from './testing/tool-call-context.js'\n"]}

package/dist-server/service/providers/anthropic.d.ts

@@ -10,4 +10,6 @@ export declare class AnthropicAIClient implements AIClient {
         url: string;
     }, prompt: string, options?: AIVisionOptions): Promise<string>;
     chatWithTools(messages: AIMessage[], tools: AITool[], options?: AIToolChatOptions): Promise<AIToolChatResult>;
+    /** Every model Anthropic lists is a conversation model. */
+    listModels(): Promise<string[]>;
 }

package/dist-server/service/providers/anthropic.js

@@ -40,6 +40,7 @@ class AnthropicAIClient {
             ...(options.stopSequences && { stop_sequences: options.stopSequences }),
             messages: conversation
         });
+        reportUsage(response, options, options.model ?? this.defaultModel);
         return extractResponseText(response);
     }
     async generateJSON(prompt, options = {}) {
@@ -86,6 +87,7 @@ class AnthropicAIClient {
             tools: sdkTools,
             ...(toolChoice && { tool_choice: toolChoice })
         });
+        reportUsage(response, options, options.model ?? this.defaultModel);
         const text = extractResponseText(response) || undefined;
         const toolCalls = Array.isArray(response.content)
             ? response.content
@@ -102,8 +104,22 @@ class AnthropicAIClient {
             stopReason: normalizeAnthropicStopReason(response.stop_reason)
         };
     }
+    /** Every model Anthropic lists is a conversation model. */
+    async listModels() {
+        const ids = [];
+        for await (const model of this.sdk.models.list())
+            ids.push(model.id);
+        return ids.sort();
+    }
 }
 exports.AnthropicAIClient = AnthropicAIClient;
+function reportUsage(response, options, requested) {
+    options.onUsage?.({
+        model: response?.model ?? requested,
+        inputTokens: response?.usage?.input_tokens,
+        outputTokens: response?.usage?.output_tokens
+    });
+}
 // ── 변환 유틸 ─────────────────────────────────────────────────────────
 function extractTextContent(msg) {
     if (typeof msg.content === 'string')