@undefineds.co/xpod 0.3.57 → 0.3.61

package/dist/api/ai-gateway/routing/RedisSessionAffinityStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisSessionAffinityStore.js","sourceRoot":"","sources":["../../../../src/api/ai-gateway/routing/RedisSessionAffinityStore.ts"],"names":[],"mappings":"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","sourcesContent":["import Redis from 'ioredis';\nimport { getLoggerFor } from 'global-logger-factory';\n\nimport {\n  affinityStorageKey,\n  cooldownStorageKey,\n  createSessionAffinityKeyDeriver,\n  isExpired,\n  type CredentialCooldownIdentity,\n  type SessionAffinityKeyDeriver,\n  type SessionAffinityEntry,\n  type SessionAffinityIdentity,\n  type SessionAffinityStore,\n} from './SessionAffinityStore';\nimport {\n  attachRedisClientErrorHandler,\n  closeRedisClient,\n} from '../../../storage/redis/RedisClientLifecycle';\n\nexport interface RedisSessionAffinityStoreOptions {\n  client: string | RedisSessionAffinityRedisClient;\n  secret?: string | Uint8Array;\n  keyDeriver?: SessionAffinityKeyDeriver;\n  namespace?: string;\n  ttlMs?: number;\n  now?: () => Date;\n}\n\nexport interface RedisSessionAffinityRedisClient {\n  get(key: string): Promise<string | null>;\n  set(key: string, value: string, ...args: unknown[]): Promise<unknown>;\n  del(key: string): Promise<unknown>;\n}\n\ninterface StoredAffinityEntry extends Omit<SessionAffinityEntry, 'expiresAt'> {\n  expiresAt?: string;\n}\n\nexport class RedisSessionAffinityStore implements SessionAffinityStore {\n  protected readonly logger = getLoggerFor(this);\n  private readonly client: RedisSessionAffinityRedisClient;\n  private readonly ownClient: Redis | undefined;\n  private readonly prefix: string;\n  private readonly keyDeriver: SessionAffinityKeyDeriver;\n  private readonly ttlMs: number;\n  private readonly now: () => Date;\n  private shuttingDown = false;\n\n  public constructor(options: RedisSessionAffinityStoreOptions) {\n    this.prefix = options.namespace ?? 'xpod:';\n    this.keyDeriver = createSessionAffinityKeyDeriver(options);\n    this.ttlMs = options.ttlMs ?? 60 * 60 * 1000;\n    this.now = options.now ?? (() => new Date());\n    if (typeof options.client === 'string') {\n      this.ownClient = new Redis(options.client, { lazyConnect: false });\n      attachRedisClientErrorHandler(this.ownClient, {\n        logger: this.logger,\n        label: 'RedisSessionAffinityStore',\n        isShuttingDown: () => this.shuttingDown,\n      });\n      this.client = this.ownClient;\n    } else {\n      this.client = options.client;\n    }\n  }\n\n  public async finalize(): Promise<void> {\n    if (!this.ownClient) {\n      return;\n    }\n    this.shuttingDown = true;\n    await closeRedisClient(this.ownClient, {\n      logger: this.logger,\n      label: 'RedisSessionAffinityStore',\n    });\n  }\n\n  public affinityKey(input: SessionAffinityIdentity): string {\n    return affinityStorageKey(input, this.keyDeriver);\n  }\n\n  public cooldownKey(input: CredentialCooldownIdentity): string {\n    return cooldownStorageKey(input, this.keyDeriver);\n  }\n\n  public async get(input: SessionAffinityIdentity): Promise<SessionAffinityEntry | undefined> {\n    const raw = await this.client.get(this.toKey(this.affinityKey(input)));\n    const entry = this.parseAffinity(raw);\n    if (!entry) {\n      return undefined;\n    }\n    const expiresAt = entry.expiresAt ? new Date(entry.expiresAt) : undefined;\n    if (isExpired(expiresAt, this.now())) {\n      await this.delete(input);\n      return undefined;\n    }\n    return {\n      ...entry,\n      expiresAt,\n    };\n  }\n\n  public async set(input: SessionAffinityEntry): Promise<void> {\n    const expiresAt = input.expiresAt ?? new Date(this.now().getTime() + this.ttlMs);\n    await this.setWithTtl(this.toKey(this.affinityKey(input)), {\n      ...input,\n      expiresAt: expiresAt.toISOString(),\n    }, expiresAt);\n  }\n\n  public async delete(input: SessionAffinityIdentity): Promise<void> {\n    await this.client.del(this.toKey(this.affinityKey(input)));\n  }\n\n  public async getCooldown(input: CredentialCooldownIdentity): Promise<Date | undefined> {\n    const raw = await this.client.get(this.toKey(this.cooldownKey(input)));\n    if (!raw) {\n      return undefined;\n    }\n    const until = new Date(raw);\n    if (!Number.isFinite(until.getTime()) || isExpired(until, this.now())) {\n      await this.client.del(this.toKey(this.cooldownKey(input)));\n      return undefined;\n    }\n    return until;\n  }\n\n  public async setCooldown(input: CredentialCooldownIdentity & { until: Date }): Promise<void> {\n    await this.setWithTtl(this.toKey(this.cooldownKey(input)), input.until.toISOString(), input.until);\n  }\n\n  public debugAffinityKey(input: SessionAffinityIdentity): string {\n    return this.affinityKey(input);\n  }\n\n  private async setWithTtl(key: string, value: unknown, expiresAt: Date): Promise<void> {\n    const ttl = Math.max(1, expiresAt.getTime() - this.now().getTime());\n    const payload = typeof value === 'string' ? value : JSON.stringify(value);\n    await this.client.set(key, payload, 'PX', ttl);\n  }\n\n  private toKey(key: string): string {\n    return `${this.prefix}${key}`;\n  }\n\n  private parseAffinity(raw: string | null): StoredAffinityEntry | undefined {\n    if (!raw) {\n      return undefined;\n    }\n    try {\n      const value = JSON.parse(raw) as Partial<StoredAffinityEntry>;\n      if (\n        typeof value.deployment !== 'string'\n        || typeof value.webId !== 'string'\n        || typeof value.conversationId !== 'string'\n        || typeof value.provider !== 'string'\n        || typeof value.credentialId !== 'string'\n      ) {\n        return undefined;\n      }\n      return value as StoredAffinityEntry;\n    } catch (error: unknown) {\n      this.logger.warn(`Failed to parse AI gateway affinity Redis payload: ${error}`);\n      return undefined;\n    }\n  }\n}\n"]}

package/dist/api/ai-gateway/routing/SessionAffinityStore.d.ts

@@ -0,0 +1,49 @@
+export interface SessionAffinityIdentity {
+    deployment: string;
+    webId: string;
+    conversationId: string;
+    provider: string;
+}
+export interface SessionAffinityEntry extends SessionAffinityIdentity {
+    credentialId: string;
+    expiresAt?: Date;
+}
+export interface CredentialCooldownIdentity {
+    deployment: string;
+    webId: string;
+    credentialId: string;
+}
+export interface SessionAffinityStore {
+    affinityKey(input: SessionAffinityIdentity): string;
+    cooldownKey(input: CredentialCooldownIdentity): string;
+    get(input: SessionAffinityIdentity): Promise<SessionAffinityEntry | undefined>;
+    set(input: SessionAffinityEntry): Promise<void>;
+    delete(input: SessionAffinityIdentity): Promise<void>;
+    getCooldown(input: CredentialCooldownIdentity): Promise<Date | undefined>;
+    setCooldown(input: CredentialCooldownIdentity & {
+        until: Date;
+    }): Promise<void>;
+}
+export interface SessionAffinityKeyDeriver {
+    hashWebId(webId: string): string;
+    hashConversationId(conversationId: string): string;
+    hashCredentialId(credentialId: string): string;
+}
+export interface HmacSessionAffinityKeyDeriverOptions {
+    secret: string | Uint8Array;
+}
+export declare class HmacSessionAffinityKeyDeriver implements SessionAffinityKeyDeriver {
+    private readonly secret;
+    constructor(options: HmacSessionAffinityKeyDeriverOptions);
+    hashWebId(webId: string): string;
+    hashConversationId(conversationId: string): string;
+    hashCredentialId(credentialId: string): string;
+    private hmac;
+}
+export declare function createSessionAffinityKeyDeriver(input: {
+    secret?: string | Uint8Array;
+    keyDeriver?: SessionAffinityKeyDeriver;
+}): SessionAffinityKeyDeriver;
+export declare function affinityStorageKey(input: SessionAffinityIdentity, keyDeriver: SessionAffinityKeyDeriver): string;
+export declare function cooldownStorageKey(input: CredentialCooldownIdentity, keyDeriver: SessionAffinityKeyDeriver): string;
+export declare function isExpired(date: Date | undefined, now: Date): boolean;

package/dist/api/ai-gateway/routing/SessionAffinityStore.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HmacSessionAffinityKeyDeriver = void 0;
+exports.createSessionAffinityKeyDeriver = createSessionAffinityKeyDeriver;
+exports.affinityStorageKey = affinityStorageKey;
+exports.cooldownStorageKey = cooldownStorageKey;
+exports.isExpired = isExpired;
+const node_crypto_1 = require("node:crypto");
+class HmacSessionAffinityKeyDeriver {
+    constructor(options) {
+        this.secret = Buffer.isBuffer(options.secret)
+            ? Buffer.from(options.secret)
+            : Buffer.from(options.secret);
+        if (this.secret.byteLength < 16) {
+            throw new Error('Session affinity key derivation secret must contain at least 128-bit entropy');
+        }
+    }
+    hashWebId(webId) {
+        return `web_${this.hmac(webId)}`;
+    }
+    hashConversationId(conversationId) {
+        return `conv_${this.hmac(conversationId)}`;
+    }
+    hashCredentialId(credentialId) {
+        return `cred_${this.hmac(credentialId)}`;
+    }
+    hmac(value) {
+        return (0, node_crypto_1.createHmac)('sha256', this.secret).update(value, 'utf8').digest('hex');
+    }
+}
+exports.HmacSessionAffinityKeyDeriver = HmacSessionAffinityKeyDeriver;
+function createSessionAffinityKeyDeriver(input) {
+    if (input.keyDeriver) {
+        return input.keyDeriver;
+    }
+    if (!input.secret) {
+        throw new Error('Session affinity key derivation requires a deployment secret');
+    }
+    return new HmacSessionAffinityKeyDeriver({ secret: input.secret });
+}
+function affinityStorageKey(input, keyDeriver) {
+    return [
+        'ai-gateway',
+        'affinity',
+        safeKeySegment(input.deployment),
+        keyDeriver.hashWebId(input.webId),
+        safeKeySegment(input.provider),
+        keyDeriver.hashConversationId(input.conversationId),
+    ].join(':');
+}
+function cooldownStorageKey(input, keyDeriver) {
+    return [
+        'ai-gateway',
+        'cooldown',
+        safeKeySegment(input.deployment),
+        keyDeriver.hashWebId(input.webId),
+        keyDeriver.hashCredentialId(input.credentialId),
+    ].join(':');
+}
+function isExpired(date, now) {
+    return Boolean(date && date.getTime() <= now.getTime());
+}
+function safeKeySegment(value) {
+    return value.trim().toLowerCase().replace(/[^a-z0-9._-]+/gu, '_');
+}
+//# sourceMappingURL=SessionAffinityStore.js.map

package/dist/api/ai-gateway/routing/SessionAffinityStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionAffinityStore.js","sourceRoot":"","sources":["../../../../src/api/ai-gateway/routing/SessionAffinityStore.ts"],"names":[],"mappings":";;;AAqEA,0EAWC;AAED,gDASC;AAED,gDAQC;AAED,8BAEC;AAzGD,6CAAyC;AAwCzC,MAAa,6BAA6B;IAGxC,YAAmB,OAA6C;QAC9D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;YAC3C,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YAC7B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,EAAE,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;QAClG,CAAC;IACH,CAAC;IAEM,SAAS,CAAC,KAAa;QAC5B,OAAO,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IACnC,CAAC;IAEM,kBAAkB,CAAC,cAAsB;QAC9C,OAAO,QAAQ,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;IAC7C,CAAC;IAEM,gBAAgB,CAAC,YAAoB;QAC1C,OAAO,QAAQ,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;IAC3C,CAAC;IAEO,IAAI,CAAC,KAAa;QACxB,OAAO,IAAA,wBAAU,EAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC;CACF;AA3BD,sEA2BC;AAED,SAAgB,+BAA+B,CAAC,KAG/C;IACC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,UAAU,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,IAAI,6BAA6B,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAA8B,EAAE,UAAqC;IACtG,OAAO;QACL,YAAY;QACZ,UAAU;QACV,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC;QAChC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;QACjC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC9B,UAAU,CAAC,kBAAkB,CAAC,KAAK,CAAC,cAAc,CAAC;KACpD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAiC,EAAE,UAAqC;IACzG,OAAO;QACL,YAAY;QACZ,UAAU;QACV,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC;QAChC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;QACjC,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,YAAY,CAAC;KAChD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,SAAgB,SAAS,CAAC,IAAsB,EAAE,GAAS;IACzD,OAAO,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AACpE,CAAC","sourcesContent":["import { createHmac } from 'node:crypto';\n\nexport interface SessionAffinityIdentity {\n  deployment: string;\n  webId: string;\n  conversationId: string;\n  provider: string;\n}\n\nexport interface SessionAffinityEntry extends SessionAffinityIdentity {\n  credentialId: string;\n  expiresAt?: Date;\n}\n\nexport interface CredentialCooldownIdentity {\n  deployment: string;\n  webId: string;\n  credentialId: string;\n}\n\nexport interface SessionAffinityStore {\n  affinityKey(input: SessionAffinityIdentity): string;\n  cooldownKey(input: CredentialCooldownIdentity): string;\n  get(input: SessionAffinityIdentity): Promise<SessionAffinityEntry | undefined>;\n  set(input: SessionAffinityEntry): Promise<void>;\n  delete(input: SessionAffinityIdentity): Promise<void>;\n  getCooldown(input: CredentialCooldownIdentity): Promise<Date | undefined>;\n  setCooldown(input: CredentialCooldownIdentity & { until: Date }): Promise<void>;\n}\n\nexport interface SessionAffinityKeyDeriver {\n  hashWebId(webId: string): string;\n  hashConversationId(conversationId: string): string;\n  hashCredentialId(credentialId: string): string;\n}\n\nexport interface HmacSessionAffinityKeyDeriverOptions {\n  secret: string | Uint8Array;\n}\n\nexport class HmacSessionAffinityKeyDeriver implements SessionAffinityKeyDeriver {\n  private readonly secret: Buffer;\n\n  public constructor(options: HmacSessionAffinityKeyDeriverOptions) {\n    this.secret = Buffer.isBuffer(options.secret)\n      ? Buffer.from(options.secret)\n      : Buffer.from(options.secret);\n    if (this.secret.byteLength < 16) {\n      throw new Error('Session affinity key derivation secret must contain at least 128-bit entropy');\n    }\n  }\n\n  public hashWebId(webId: string): string {\n    return `web_${this.hmac(webId)}`;\n  }\n\n  public hashConversationId(conversationId: string): string {\n    return `conv_${this.hmac(conversationId)}`;\n  }\n\n  public hashCredentialId(credentialId: string): string {\n    return `cred_${this.hmac(credentialId)}`;\n  }\n\n  private hmac(value: string): string {\n    return createHmac('sha256', this.secret).update(value, 'utf8').digest('hex');\n  }\n}\n\nexport function createSessionAffinityKeyDeriver(input: {\n  secret?: string | Uint8Array;\n  keyDeriver?: SessionAffinityKeyDeriver;\n}): SessionAffinityKeyDeriver {\n  if (input.keyDeriver) {\n    return input.keyDeriver;\n  }\n  if (!input.secret) {\n    throw new Error('Session affinity key derivation requires a deployment secret');\n  }\n  return new HmacSessionAffinityKeyDeriver({ secret: input.secret });\n}\n\nexport function affinityStorageKey(input: SessionAffinityIdentity, keyDeriver: SessionAffinityKeyDeriver): string {\n  return [\n    'ai-gateway',\n    'affinity',\n    safeKeySegment(input.deployment),\n    keyDeriver.hashWebId(input.webId),\n    safeKeySegment(input.provider),\n    keyDeriver.hashConversationId(input.conversationId),\n  ].join(':');\n}\n\nexport function cooldownStorageKey(input: CredentialCooldownIdentity, keyDeriver: SessionAffinityKeyDeriver): string {\n  return [\n    'ai-gateway',\n    'cooldown',\n    safeKeySegment(input.deployment),\n    keyDeriver.hashWebId(input.webId),\n    keyDeriver.hashCredentialId(input.credentialId),\n  ].join(':');\n}\n\nexport function isExpired(date: Date | undefined, now: Date): boolean {\n  return Boolean(date && date.getTime() <= now.getTime());\n}\n\nfunction safeKeySegment(value: string): string {\n  return value.trim().toLowerCase().replace(/[^a-z0-9._-]+/gu, '_');\n}\n"]}

package/dist/api/ai-gateway/service-access/AiConnectionServiceAccess.d.ts

@@ -0,0 +1,25 @@
+export declare const AI_CONNECTION_APPLET_ID = "co.undefineds.ai-connection";
+export interface AiConnectionServiceAccessDescriptor {
+    appletId: typeof AI_CONNECTION_APPLET_ID;
+    service: {
+        webId: string;
+        label: 'Xpod AI Connection';
+    };
+    resources: AiConnectionServiceAccessResource[];
+}
+export interface AiConnectionServiceAccessResource {
+    id: 'providerCredentials' | 'providerDefinitions' | 'gatewayAccessKeys' | 'quotaSnapshots';
+    url: string;
+    mediaType: 'text/turtle';
+    access: {
+        read: true;
+        append: true;
+        write: true;
+        controlRead?: never;
+        controlWrite?: never;
+    };
+}
+export declare function createAiConnectionServiceAccess(input: {
+    ownerWebId: string;
+    serviceWebId: string;
+}): AiConnectionServiceAccessDescriptor;

package/dist/api/ai-gateway/service-access/AiConnectionServiceAccess.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_CONNECTION_APPLET_ID = void 0;
+exports.createAiConnectionServiceAccess = createAiConnectionServiceAccess;
+const drizzle_solid_1 = require("@undefineds.co/drizzle-solid");
+const models_1 = require("@undefineds.co/models");
+exports.AI_CONNECTION_APPLET_ID = 'co.undefineds.ai-connection';
+const declaredResourceBases = new WeakMap([
+    [models_1.credentialResource, declaredResourceBase(models_1.credentialResource)],
+    [models_1.aiProviderResource, declaredResourceBase(models_1.aiProviderResource)],
+    [models_1.gatewayAccessKeyResource, declaredResourceBase(models_1.gatewayAccessKeyResource)],
+    [models_1.quotaSnapshotResource, declaredResourceBase(models_1.quotaSnapshotResource)],
+]);
+function createAiConnectionServiceAccess(input) {
+    return {
+        appletId: exports.AI_CONNECTION_APPLET_ID,
+        service: {
+            webId: input.serviceWebId,
+            label: 'Xpod AI Connection',
+        },
+        resources: [
+            ['providerCredentials', resourceUrl(input.ownerWebId, models_1.credentialResource)],
+            ['providerDefinitions', resourceUrl(input.ownerWebId, models_1.aiProviderResource)],
+            ['gatewayAccessKeys', resourceUrl(input.ownerWebId, models_1.gatewayAccessKeyResource)],
+            ['quotaSnapshots', resourceUrl(input.ownerWebId, models_1.quotaSnapshotResource)],
+        ].map(([id, url]) => ({
+            id,
+            url,
+            mediaType: 'text/turtle',
+            access: { read: true, append: true, write: true },
+        })),
+    };
+}
+function resourceUrl(ownerWebId, resource) {
+    const podRoot = `${(0, drizzle_solid_1.resolvePodBaseUrl)(ownerWebId).replace(/\/$/u, '')}/`;
+    const resourcePath = declaredResourceBases.get(resource);
+    if (!resourcePath) {
+        throw new Error('AI Connection resource is missing an immutable declared base');
+    }
+    const documentPath = resource.buildId({ id: '__service_access__' }).split('#')[0];
+    return new URL(`${resourcePath}/${documentPath}`.replace(/^\/+/u, ''), podRoot).href;
+}
+function declaredResourceBase(resource) {
+    const base = resource.config?.base?.replace(/^\/+|\/+$/gu, '');
+    if (!base) {
+        throw new Error('AI Connection resource is missing a declared base');
+    }
+    return base;
+}
+//# sourceMappingURL=AiConnectionServiceAccess.js.map

package/dist/api/ai-gateway/service-access/AiConnectionServiceAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiConnectionServiceAccess.js","sourceRoot":"","sources":["../../../../src/api/ai-gateway/service-access/AiConnectionServiceAccess.ts"],"names":[],"mappings":";;;AA8CA,0EAsBC;AApED,gEAAiE;AACjE,kDAK+B;AAElB,QAAA,uBAAuB,GAAG,6BAA6B,CAAC;AA+BrE,MAAM,qBAAqB,GAAG,IAAI,OAAO,CAAiB;IACxD,CAAC,2BAAkB,EAAE,oBAAoB,CAAC,2BAAkB,CAAC,CAAC;IAC9D,CAAC,2BAAkB,EAAE,oBAAoB,CAAC,2BAAkB,CAAC,CAAC;IAC9D,CAAC,iCAAwB,EAAE,oBAAoB,CAAC,iCAAwB,CAAC,CAAC;IAC1E,CAAC,8BAAqB,EAAE,oBAAoB,CAAC,8BAAqB,CAAC,CAAC;CACrE,CAAC,CAAC;AAEH,SAAgB,+BAA+B,CAAC,KAG/C;IACC,OAAO;QACL,QAAQ,EAAE,+BAAuB;QACjC,OAAO,EAAE;YACP,KAAK,EAAE,KAAK,CAAC,YAAY;YACzB,KAAK,EAAE,oBAAoB;SAC5B;QACD,SAAS,EAAE;YACT,CAAC,qBAAqB,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,2BAAkB,CAAC,CAAC;YAC1E,CAAC,qBAAqB,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,2BAAkB,CAAC,CAAC;YAC1E,CAAC,mBAAmB,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,iCAAwB,CAAC,CAAC;YAC9E,CAAC,gBAAgB,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,8BAAqB,CAAC,CAAC;SACzE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YACpB,EAAE;YACF,GAAG;YACH,SAAS,EAAE,aAAa;YACxB,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;SAClD,CAAC,CAAwC;KAC3C,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB,EAAE,QAA4B;IACnE,MAAM,OAAO,GAAG,GAAG,IAAA,iCAAiB,EAAC,UAAU,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC;IACxE,MAAM,YAAY,GAAG,qBAAqB,CAAC,GAAG,CAAC,QAAkB,CAAC,CAAC;IACnE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,OAAO,IAAI,GAAG,CAAC,GAAG,YAAY,IAAI,YAAY,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AACvF,CAAC;AAED,SAAS,oBAAoB,CAAC,QAA4B;IACxD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC/D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import { resolvePodBaseUrl } from '@undefineds.co/drizzle-solid';\nimport {\n  aiProviderResource,\n  credentialResource,\n  gatewayAccessKeyResource,\n  quotaSnapshotResource,\n} from '@undefineds.co/models';\n\nexport const AI_CONNECTION_APPLET_ID = 'co.undefineds.ai-connection';\n\nexport interface AiConnectionServiceAccessDescriptor {\n  appletId: typeof AI_CONNECTION_APPLET_ID;\n  service: {\n    webId: string;\n    label: 'Xpod AI Connection';\n  };\n  resources: AiConnectionServiceAccessResource[];\n}\n\nexport interface AiConnectionServiceAccessResource {\n  id: 'providerCredentials' | 'providerDefinitions' | 'gatewayAccessKeys' | 'quotaSnapshots';\n  url: string;\n  mediaType: 'text/turtle';\n  access: {\n    read: true;\n    append: true;\n    write: true;\n    controlRead?: never;\n    controlWrite?: never;\n  };\n}\n\ninterface PodResourceLocator {\n  config?: {\n    base?: string;\n  };\n  buildId(value: { id: string }): string;\n}\n\nconst declaredResourceBases = new WeakMap<object, string>([\n  [credentialResource, declaredResourceBase(credentialResource)],\n  [aiProviderResource, declaredResourceBase(aiProviderResource)],\n  [gatewayAccessKeyResource, declaredResourceBase(gatewayAccessKeyResource)],\n  [quotaSnapshotResource, declaredResourceBase(quotaSnapshotResource)],\n]);\n\nexport function createAiConnectionServiceAccess(input: {\n  ownerWebId: string;\n  serviceWebId: string;\n}): AiConnectionServiceAccessDescriptor {\n  return {\n    appletId: AI_CONNECTION_APPLET_ID,\n    service: {\n      webId: input.serviceWebId,\n      label: 'Xpod AI Connection',\n    },\n    resources: [\n      ['providerCredentials', resourceUrl(input.ownerWebId, credentialResource)],\n      ['providerDefinitions', resourceUrl(input.ownerWebId, aiProviderResource)],\n      ['gatewayAccessKeys', resourceUrl(input.ownerWebId, gatewayAccessKeyResource)],\n      ['quotaSnapshots', resourceUrl(input.ownerWebId, quotaSnapshotResource)],\n    ].map(([id, url]) => ({\n      id,\n      url,\n      mediaType: 'text/turtle',\n      access: { read: true, append: true, write: true },\n    })) as AiConnectionServiceAccessResource[],\n  };\n}\n\nfunction resourceUrl(ownerWebId: string, resource: PodResourceLocator): string {\n  const podRoot = `${resolvePodBaseUrl(ownerWebId).replace(/\\/$/u, '')}/`;\n  const resourcePath = declaredResourceBases.get(resource as object);\n  if (!resourcePath) {\n    throw new Error('AI Connection resource is missing an immutable declared base');\n  }\n  const documentPath = resource.buildId({ id: '__service_access__' }).split('#')[0];\n  return new URL(`${resourcePath}/${documentPath}`.replace(/^\\/+/u, ''), podRoot).href;\n}\n\nfunction declaredResourceBase(resource: PodResourceLocator): string {\n  const base = resource.config?.base?.replace(/^\\/+|\\/+$/gu, '');\n  if (!base) {\n    throw new Error('AI Connection resource is missing a declared base');\n  }\n  return base;\n}\n"]}

package/dist/api/ai-gateway/types.d.ts

@@ -0,0 +1,112 @@
+export type GatewayProtocol = 'responses' | 'anthropic' | 'chatCompletions';
+export type GatewayMessageRole = 'system' | 'developer' | 'user' | 'assistant' | 'tool';
+export type GatewayContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    imageUrl?: string;
+    mediaType?: string;
+    data?: string;
+    detail?: string;
+};
+export interface GatewayMessage {
+    role: GatewayMessageRole;
+    content: GatewayContentPart[];
+    name?: string;
+    toolCallId?: string;
+    protocolExtensions?: Record<string, unknown>;
+}
+export interface GatewayTool {
+    type: 'function';
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+    protocolExtensions?: Record<string, unknown>;
+}
+export interface GatewayReasoningOptions {
+    effort?: string;
+    exposeSummary?: boolean;
+}
+export interface GatewayUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+export interface GatewayRequest {
+    model: string;
+    instructions?: string;
+    messages: GatewayMessage[];
+    tools: GatewayTool[];
+    reasoning?: GatewayReasoningOptions;
+    maxOutputTokens?: number;
+    previousResponseId?: string;
+    stream: boolean;
+    protocolExtensions: Partial<Record<GatewayProtocol, Record<string, unknown>>>;
+}
+export type GatewayEvent = {
+    type: 'response.started';
+    id: string;
+} | {
+    type: 'text.delta';
+    text: string;
+} | {
+    type: 'reasoning.delta';
+    text: string;
+} | {
+    type: 'reasoning.signature';
+    provider: string;
+    signature: string;
+} | {
+    type: 'tool.started';
+    callId: string;
+    name: string;
+} | {
+    type: 'tool.arguments.delta';
+    callId: string;
+    delta: string;
+} | {
+    type: 'tool.completed';
+    callId: string;
+} | {
+    type: 'usage';
+    usage: GatewayUsage;
+} | {
+    type: 'response.completed';
+    finishReason: string;
+};
+export interface GatewayEventSerializer {
+    serializeEvent(event: GatewayEvent): Record<string, unknown> | Record<string, unknown>[];
+}
+export interface GatewayProtocolFrontend {
+    readonly protocol: GatewayProtocol;
+    parseRequest(body: unknown): GatewayRequest;
+    createEventSerializer(): GatewayEventSerializer;
+}
+export declare function requireObject(value: unknown, context: string): Record<string, unknown>;
+export declare function stringOrUndefined(value: unknown): string | undefined;
+export declare function booleanValue(value: unknown): boolean;
+export declare function extractExtension(body: Record<string, unknown>, protocol: GatewayProtocol, normalizedKeys: readonly string[]): Partial<Record<GatewayProtocol, Record<string, unknown>>>;
+export declare function extractText(value: unknown): string | undefined;
+export declare function normalizeContentParts(content: unknown, protocol: GatewayProtocol): GatewayContentPart[];
+export declare function normalizeToolFromResponses(tool: unknown): GatewayTool | undefined;
+export declare function normalizeToolFromAnthropic(tool: unknown): GatewayTool | undefined;
+export declare function normalizeToolFromChat(tool: unknown): GatewayTool | undefined;
+export declare function normalizeMessage(message: unknown, protocol: GatewayProtocol): GatewayMessage | undefined;
+export declare function mapGatewayUsageToOpenAi(usage: GatewayUsage): Record<string, unknown>;
+export declare function mapGatewayUsageToChatCompletions(usage: GatewayUsage): Record<string, unknown>;
+export declare function mapGatewayUsageToAnthropic(usage: GatewayUsage): Record<string, unknown>;
+export declare class ToolArgumentTracker {
+    private readonly chunks;
+    private readonly toolIndexes;
+    private nextIndex;
+    reset(): void;
+    start(callId: string): number;
+    append(callId: string, delta: string): number;
+    argumentsFor(callId: string): string;
+    complete(callId: string): number;
+    private requireStarted;
+}
+export declare function unsupportedEvent(event: GatewayEvent): never;

package/dist/api/ai-gateway/types.js

@@ -0,0 +1,305 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolArgumentTracker = void 0;
+exports.requireObject = requireObject;
+exports.stringOrUndefined = stringOrUndefined;
+exports.booleanValue = booleanValue;
+exports.extractExtension = extractExtension;
+exports.extractText = extractText;
+exports.normalizeContentParts = normalizeContentParts;
+exports.normalizeToolFromResponses = normalizeToolFromResponses;
+exports.normalizeToolFromAnthropic = normalizeToolFromAnthropic;
+exports.normalizeToolFromChat = normalizeToolFromChat;
+exports.normalizeMessage = normalizeMessage;
+exports.mapGatewayUsageToOpenAi = mapGatewayUsageToOpenAi;
+exports.mapGatewayUsageToChatCompletions = mapGatewayUsageToChatCompletions;
+exports.mapGatewayUsageToAnthropic = mapGatewayUsageToAnthropic;
+exports.unsupportedEvent = unsupportedEvent;
+const errors_1 = require("./errors");
+function requireObject(value, context) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new errors_1.GatewayProtocolError(`${context} must be an object`);
+    }
+    return value;
+}
+function stringOrUndefined(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function booleanValue(value) {
+    return value === true;
+}
+function extractExtension(body, protocol, normalizedKeys) {
+    const normalized = new Set(normalizedKeys);
+    const extension = {};
+    for (const [key, value] of Object.entries(body)) {
+        if (!normalized.has(key)) {
+            extension[key] = value;
+        }
+    }
+    return Object.keys(extension).length > 0 ? { [protocol]: extension } : {};
+}
+function extractText(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        const parts = value
+            .map((item) => {
+            if (typeof item === 'string') {
+                return item;
+            }
+            if (item && typeof item === 'object' && typeof item.text === 'string') {
+                return item.text;
+            }
+            return undefined;
+        })
+            .filter((item) => item !== undefined);
+        return parts.length > 0 ? parts.join('\n') : undefined;
+    }
+    if (value == null) {
+        return undefined;
+    }
+    return String(value);
+}
+function normalizeContentParts(content, protocol) {
+    if (typeof content === 'string') {
+        return [{ type: 'text', text: content }];
+    }
+    if (!Array.isArray(content)) {
+        if (content && typeof content === 'object') {
+            return normalizeContentParts([content], protocol);
+        }
+        const text = extractText(content);
+        return text ? [{ type: 'text', text }] : [];
+    }
+    return content.flatMap((part) => {
+        if (typeof part === 'string') {
+            return [{ type: 'text', text: part }];
+        }
+        if (!part || typeof part !== 'object') {
+            return [];
+        }
+        const record = part;
+        const type = record.type;
+        if (type === 'text'
+            || type === 'input_text'
+            || type === 'output_text') {
+            const text = stringOrUndefined(record.text);
+            return text ? [{ type: 'text', text }] : [];
+        }
+        if (type === 'image_url') {
+            const imageUrl = record.image_url;
+            if (typeof imageUrl === 'string') {
+                return [{ type: 'image', imageUrl }];
+            }
+            if (imageUrl && typeof imageUrl === 'object') {
+                const image = imageUrl;
+                return [{
+                        type: 'image',
+                        imageUrl: stringOrUndefined(image.url),
+                        detail: stringOrUndefined(image.detail),
+                    }];
+            }
+        }
+        if (type === 'input_image') {
+            return [{
+                    type: 'image',
+                    imageUrl: stringOrUndefined(record.image_url) ?? stringOrUndefined(record.file_id),
+                    detail: stringOrUndefined(record.detail),
+                }];
+        }
+        if (type === 'image' && protocol === 'anthropic') {
+            const source = record.source;
+            if (source && typeof source === 'object') {
+                const image = source;
+                return [{
+                        type: 'image',
+                        mediaType: stringOrUndefined(image.media_type),
+                        data: stringOrUndefined(image.data),
+                    }];
+            }
+        }
+        return [];
+    });
+}
+function normalizeToolFromResponses(tool) {
+    if (!tool || typeof tool !== 'object') {
+        return undefined;
+    }
+    const record = tool;
+    const name = stringOrUndefined(record.name);
+    if (!name) {
+        return undefined;
+    }
+    return {
+        type: 'function',
+        name,
+        description: stringOrUndefined(record.description),
+        inputSchema: record.parameters && typeof record.parameters === 'object'
+            ? record.parameters
+            : undefined,
+    };
+}
+function normalizeToolFromAnthropic(tool) {
+    if (!tool || typeof tool !== 'object') {
+        return undefined;
+    }
+    const record = tool;
+    const name = stringOrUndefined(record.name);
+    if (!name) {
+        return undefined;
+    }
+    return {
+        type: 'function',
+        name,
+        description: stringOrUndefined(record.description),
+        inputSchema: record.input_schema && typeof record.input_schema === 'object'
+            ? record.input_schema
+            : undefined,
+    };
+}
+function normalizeToolFromChat(tool) {
+    if (!tool || typeof tool !== 'object') {
+        return undefined;
+    }
+    const record = tool;
+    const fn = record.function;
+    if (!fn || typeof fn !== 'object') {
+        return undefined;
+    }
+    const functionRecord = fn;
+    const name = stringOrUndefined(functionRecord.name);
+    if (!name) {
+        return undefined;
+    }
+    return {
+        type: 'function',
+        name,
+        description: stringOrUndefined(functionRecord.description),
+        inputSchema: functionRecord.parameters && typeof functionRecord.parameters === 'object'
+            ? functionRecord.parameters
+            : undefined,
+    };
+}
+function normalizeMessage(message, protocol) {
+    if (!message || typeof message !== 'object') {
+        return undefined;
+    }
+    const record = message;
+    const role = stringOrUndefined(record.role);
+    if (!role) {
+        return undefined;
+    }
+    return {
+        role: role,
+        content: normalizeContentParts(record.content, protocol),
+        name: stringOrUndefined(record.name),
+        toolCallId: stringOrUndefined(record.tool_call_id) ?? stringOrUndefined(record.tool_use_id),
+    };
+}
+function mapGatewayUsageToOpenAi(usage) {
+    return {
+        ...(usage.inputTokens !== undefined ? { input_tokens: usage.inputTokens } : {}),
+        ...(usage.outputTokens !== undefined ? { output_tokens: usage.outputTokens } : {}),
+        ...(usage.totalTokens !== undefined ? { total_tokens: usage.totalTokens } : {}),
+        ...(usage.cacheReadTokens !== undefined || usage.cacheWriteTokens !== undefined
+            ? {
+                input_tokens_details: {
+                    ...(usage.cacheReadTokens !== undefined ? { cached_tokens: usage.cacheReadTokens } : {}),
+                    ...(usage.cacheWriteTokens !== undefined ? { cache_write_tokens: usage.cacheWriteTokens } : {}),
+                },
+            }
+            : {}),
+    };
+}
+function mapGatewayUsageToChatCompletions(usage) {
+    return {
+        ...(usage.inputTokens !== undefined ? { prompt_tokens: usage.inputTokens } : {}),
+        ...(usage.outputTokens !== undefined ? { completion_tokens: usage.outputTokens } : {}),
+        ...(usage.totalTokens !== undefined ? { total_tokens: usage.totalTokens } : {}),
+        ...(usage.cacheReadTokens !== undefined || usage.cacheWriteTokens !== undefined
+            ? {
+                prompt_tokens_details: {
+                    ...(usage.cacheReadTokens !== undefined ? { cached_tokens: usage.cacheReadTokens } : {}),
+                    ...(usage.cacheWriteTokens !== undefined ? { cache_write_tokens: usage.cacheWriteTokens } : {}),
+                },
+            }
+            : {}),
+    };
+}
+function mapGatewayUsageToAnthropic(usage) {
+    return {
+        ...(usage.inputTokens !== undefined ? { input_tokens: usage.inputTokens } : {}),
+        ...(usage.outputTokens !== undefined ? { output_tokens: usage.outputTokens } : {}),
+        ...(usage.cacheReadTokens !== undefined ? { cache_read_input_tokens: usage.cacheReadTokens } : {}),
+        ...(usage.cacheWriteTokens !== undefined ? { cache_creation_input_tokens: usage.cacheWriteTokens } : {}),
+    };
+}
+class ToolArgumentTracker {
+    constructor() {
+        this.chunks = new Map();
+        this.toolIndexes = new Map();
+        this.nextIndex = 0;
+    }
+    reset() {
+        this.chunks.clear();
+        this.toolIndexes.clear();
+        this.nextIndex = 0;
+    }
+    start(callId) {
+        if (!this.toolIndexes.has(callId)) {
+            this.toolIndexes.set(callId, this.nextIndex);
+            this.nextIndex += 1;
+        }
+        if (!this.chunks.has(callId)) {
+            this.chunks.set(callId, '');
+        }
+        return this.toolIndexes.get(callId) ?? 0;
+    }
+    append(callId, delta) {
+        const index = this.requireStarted(callId);
+        this.chunks.set(callId, `${this.chunks.get(callId) ?? ''}${delta}`);
+        return index;
+    }
+    argumentsFor(callId) {
+        this.requireStarted(callId);
+        return this.chunks.get(callId) ?? '';
+    }
+    complete(callId) {
+        const index = this.requireStarted(callId);
+        const value = this.chunks.get(callId) ?? '';
+        try {
+            JSON.parse(value || '{}');
+        }
+        catch (error) {
+            throw new errors_1.GatewayProtocolError('Completed tool arguments must be valid JSON', {
+                code: 'invalid_tool_arguments',
+                status: 400,
+                details: { callId },
+                cause: error,
+            });
+        }
+        this.chunks.delete(callId);
+        this.toolIndexes.delete(callId);
+        return index;
+    }
+    requireStarted(callId) {
+        const index = this.toolIndexes.get(callId);
+        if (index === undefined || !this.chunks.has(callId)) {
+            throw new errors_1.GatewayProtocolError('Tool arguments event received before tool start', {
+                code: 'invalid_tool_arguments',
+                status: 400,
+                details: { callId },
+            });
+        }
+        return index;
+    }
+}
+exports.ToolArgumentTracker = ToolArgumentTracker;
+function unsupportedEvent(event) {
+    throw new errors_1.GatewayProtocolError(`Unsupported gateway event: ${event.type}`, {
+        code: 'unsupported_protocol_event',
+        status: 500,
+    });
+}
+//# sourceMappingURL=types.js.map