@alexkroman1/aai 1.6.1 → 1.7.1

package/.turbo/turbo-build.log

@@ -1,26 +1,30 @@
 
-> @alexkroman1/aai@1.6.1 build /home/runner/work/agent/agent/packages/aai
+> @alexkroman1/aai@1.7.1 build /home/runner/work/agent/agent/packages/aai
 > tsdown && tsc -p tsconfig.build.json
 
 ℹ tsdown v0.21.7 powered by rolldown v1.0.0-rc.12
 ℹ config file: /home/runner/work/agent/agent/packages/aai/tsdown.config.ts 
-ℹ entry: index.ts, sdk/protocol.ts, host/runtime-barrel.ts, sdk/manifest-barrel.ts, sdk/providers/stt-barrel.ts, sdk/providers/tts-barrel.ts, sdk/providers/llm-barrel.ts
+ℹ entry: index.ts, sdk/protocol.ts, host/runtime-barrel.ts, sdk/manifest-barrel.ts, sdk/providers/stt-barrel.ts, sdk/providers/tts-barrel.ts, sdk/providers/llm-barrel.ts, sdk/providers/vector-barrel.ts, sdk/providers/kv-barrel.ts
 ℹ target: node22
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/host/runtime-barrel.js       102.24 kB │ gzip: 28.92 kB
-ℹ dist/sdk/protocol.js                4.75 kB │ gzip:  1.76 kB
-ℹ dist/index.js                       2.88 kB │ gzip:  1.24 kB
-ℹ dist/sdk/manifest-barrel.js         0.36 kB │ gzip:  0.20 kB
-ℹ dist/sdk/providers/llm-barrel.js    0.36 kB │ gzip:  0.21 kB
-ℹ dist/sdk/providers/stt-barrel.js    0.30 kB │ gzip:  0.20 kB
-ℹ dist/sdk/providers/tts-barrel.js    0.26 kB │ gzip:  0.16 kB
-ℹ dist/_internal-types-DFL07G3f.js    5.66 kB │ gzip:  2.10 kB
-ℹ dist/types-KUgezM6u.js              5.64 kB │ gzip:  2.39 kB
-ℹ dist/constants-C2nirZUI.js          3.10 kB │ gzip:  1.38 kB
-ℹ dist/soniox-DCQ3GqJq.js             2.03 kB │ gzip:  0.54 kB
-ℹ dist/xai-jfQsxxPZ.js                1.18 kB │ gzip:  0.35 kB
-ℹ dist/ws-upgrade-BeOQ7fXL.js         1.14 kB │ gzip:  0.54 kB
-ℹ dist/cartesia-BfQPOQ7Y.js           1.08 kB │ gzip:  0.50 kB
-ℹ 14 files, total: 130.99 kB
-✔ Build complete in 50ms
+ℹ dist/host/runtime-barrel.js          113.03 kB │ gzip: 32.35 kB
+ℹ dist/sdk/protocol.js                   5.70 kB │ gzip:  1.92 kB
+ℹ dist/index.js                          2.88 kB │ gzip:  1.24 kB
+ℹ dist/sdk/manifest-barrel.js            0.36 kB │ gzip:  0.20 kB
+ℹ dist/sdk/providers/llm-barrel.js       0.36 kB │ gzip:  0.22 kB
+ℹ dist/sdk/providers/stt-barrel.js       0.30 kB │ gzip:  0.19 kB
+ℹ dist/sdk/providers/kv-barrel.js        0.26 kB │ gzip:  0.17 kB
+ℹ dist/sdk/providers/tts-barrel.js       0.25 kB │ gzip:  0.16 kB
+ℹ dist/sdk/providers/vector-barrel.js    0.22 kB │ gzip:  0.15 kB
+ℹ dist/_internal-types-CrnTi9Ew.js       5.93 kB │ gzip:  2.13 kB
+ℹ dist/types-KUgezM6u.js                 5.64 kB │ gzip:  2.39 kB
+ℹ dist/constants-C2nirZUI.js             3.10 kB │ gzip:  1.38 kB
+ℹ dist/soniox-BQdL0mB5.js                2.03 kB │ gzip:  0.54 kB
+ℹ dist/xai-BDI61Y2M.js                   1.18 kB │ gzip:  0.35 kB
+ℹ dist/ws-upgrade-BeOQ7fXL.js            1.14 kB │ gzip:  0.54 kB
+ℹ dist/rime-58p9mDR8.js                  1.08 kB │ gzip:  0.51 kB
+ℹ dist/s3-BtCMvCod.js                    0.76 kB │ gzip:  0.29 kB
+ℹ dist/pinecone-CeJ69aRs.js              0.48 kB │ gzip:  0.24 kB
+ℹ 18 files, total: 144.72 kB
+✔ Build complete in 54ms

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @alexkroman1/aai
 
+## 1.7.1
+
+### Patch Changes
+
+- 3c711da: Stop per-frame debug log spam when S2S socket is closed; sendAudio now silently drops frames matching sendAudioRaw and pipeline/STT behavior. Closure is still logged once via the WebSocket close event.
+
+## 1.7.0
+
+### Minor Changes
+
+- 07b4263: Pluggable KV and Vector backends. New subpath exports @alexkroman1/aai/kv and @alexkroman1/aai/vector. New ctx.vector tool context field. Pinecone (integrated inference) and Redis/S3/fs/memory backends ship out of the box.
+
+### Patch Changes
+
+- b79855d: Change S2S/agent API base URL to wss://agents.assemblyai.com/v1/ws
+
 ## 1.6.1
 
 ### Patch Changes

package/dist/{_internal-types-DFL07G3f.js → _internal-types-CrnTi9Ew.js}

@@ -65,7 +65,9 @@ z.object({
 	}),
 	stt: ProviderDescriptorSchema.optional(),
 	llm: ProviderDescriptorSchema.optional(),
-	tts: ProviderDescriptorSchema.optional()
+	tts: ProviderDescriptorSchema.optional(),
+	kv: ProviderDescriptorSchema.optional(),
+	vector: ProviderDescriptorSchema.optional()
 });
 //#endregion
 //#region sdk/_internal-types.ts
@@ -87,7 +89,9 @@ const AgentConfigSchema = z.object({
 	stt: ProviderDescriptorSchema.optional(),
 	llm: ProviderDescriptorSchema.optional(),
 	tts: ProviderDescriptorSchema.optional(),
-	mode: z.enum(["s2s", "pipeline"]).optional()
+	mode: z.enum(["s2s", "pipeline"]).optional(),
+	kv: ProviderDescriptorSchema.optional(),
+	vector: ProviderDescriptorSchema.optional()
 });
 /**
 * Extract the serializable {@link AgentConfig} subset from a source object.
@@ -113,6 +117,8 @@ function toAgentConfig(src) {
 		config.llm = src.llm;
 		config.tts = src.tts;
 	}
+	if (src.kv !== void 0) config.kv = src.kv;
+	if (src.vector !== void 0) config.vector = src.vector;
 	return config;
 }
 /**

package/dist/host/memory-vector.d.ts

@@ -0,0 +1,17 @@
+/**
+ * In-memory Vector implementation.
+ *
+ * INTENTIONALLY BAD QUALITY. Pseudo-embedding hashes the text into a
+ * 64-dim Float32Array of values in [-1, ~0.99], then L2-normalizes
+ * the result. Because both stored and probe vectors are unit-length,
+ * cosine similarity reduces to a plain dot product — that's what
+ * `cosine()` computes. Used only for `aai dev` and tests — the goal
+ * is proving tool wiring, not retrieval ranking.
+ */
+import type { Vector } from "../sdk/vector.ts";
+export type MemoryVectorOptions = {
+    namespace: string;
+};
+export declare function createMemoryVector(opts: MemoryVectorOptions): Vector;
+/** Test-only: clear all in-memory state. Not exported from the package. */
+export declare function _resetMemoryVectorForTests(): void;

package/dist/host/pinecone-vector.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pinecone Vector implementation using integrated inference.
+ *
+ * The Pinecone index must be created with an embed config (e.g.
+ * `multilingual-e5-large`); we never see the embedding vectors.
+ *
+ * `@pinecone-database/pinecone` is loaded lazily via `createRequire`
+ * so the package becomes a true *optional* peer dependency: if a
+ * deployment doesn't use Pinecone, the missing package is never
+ * imported.
+ */
+import type { Vector } from "../sdk/vector.ts";
+export type PineconeVectorOptions = {
+    apiKey: string;
+    index: string;
+    /** Per-tenant namespace — set by the server to the agent slug. */
+    namespace: string;
+};
+export declare function createPineconeVector(opts: PineconeVectorOptions): Vector;

package/dist/host/providers/resolve-kv.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Descriptor → concrete `Kv` resolver. Mirror of `resolveLlm` /
+ * `resolveVector`. Always wraps the produced unstorage Storage in
+ * `createUnstorageKv` with the provided per-tenant prefix so namespace
+ * isolation is enforced regardless of backend choice.
+ */
+import type { Kv } from "../../sdk/kv.ts";
+import type { KvProvider } from "../../sdk/providers.ts";
+/** Resolve a {@link KvProvider} descriptor into a {@link Kv}. */
+export declare function resolveKv(descriptor: KvProvider, env: Record<string, string>, prefix: string): Kv;

package/dist/host/providers/resolve-vector.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Descriptor → concrete `Vector` resolver. Mirror of `resolveLlm`.
+ *
+ * Pulls API keys from the agent env so descriptors stay
+ * secret-free. Lazy-loads provider SDKs via `createRequire` so
+ * unused providers never enter the bundle.
+ */
+import type { VectorProvider } from "../../sdk/providers.ts";
+import type { Vector } from "../../sdk/vector.ts";
+/** Resolve a {@link VectorProvider} descriptor into a {@link Vector}. */
+export declare function resolveVector(descriptor: VectorProvider, env: Record<string, string>, namespace: string): Vector;

package/dist/host/providers/resolve.d.ts

@@ -32,3 +32,9 @@ export declare function resolveTts(descriptor: TtsProvider): TtsOpener;
  * `streamText` call otherwise, and the error is clearer at construction.
  */
 export declare function resolveLlm(descriptor: LlmProvider, env: Record<string, string>): LanguageModel;
+/**
+ * Lazy-load a package via createRequire so the package is a true optional
+ * peer dependency — if it's not installed the error surfaces only when the
+ * provider is actually used, not at module load time.
+ */
+export declare function loadProviderPackage<T>(name: string, label: string): T;

package/dist/host/runtime-barrel.d.ts

@@ -3,7 +3,12 @@
  *
  * Used by aai-server (sandbox) and aai-cli (dev server).
  */
+export type { Vector, VectorMatch, VectorQueryOptions } from "../sdk/vector.ts";
 export * from "./builtin-tools.ts";
+export { createMemoryVector, type MemoryVectorOptions } from "./memory-vector.ts";
+export * from "./pinecone-vector.ts";
+export * from "./providers/resolve-kv.ts";
+export * from "./providers/resolve-vector.ts";
 export * from "./runtime.ts";
 export * from "./runtime-config.ts";
 export * from "./server.ts";