sideagent 0.3.0 → 0.4.0

package/dist/keys.d.ts

@@ -0,0 +1,16 @@
+type KeyEnvironment = "test" | "live";
+interface PublishableKeyParts {
+    environment: KeyEnvironment;
+    /** host[:port], no scheme. */
+    host: string;
+    agentId: string;
+}
+/** Request header that carries the publishable key. Authorization stays free for the user's token. */
+declare const PUBLISHABLE_KEY_HEADER = "x-sideagent-key";
+declare function publishableKey(environment: KeyEnvironment, host: string, agentId: string): string;
+/** The key's parts, or null when it is not a well-formed publishable key. */
+declare function parsePublishableKey(key: string): PublishableKeyParts | null;
+/** The agent's data-plane URL. https, except http for localhost and 127.0.0.1 (local development). */
+declare function publishableEndpoint({ host, agentId }: PublishableKeyParts): string;
+
+export { type KeyEnvironment, PUBLISHABLE_KEY_HEADER, type PublishableKeyParts, parsePublishableKey, publishableEndpoint, publishableKey };

package/dist/keys.js

@@ -0,0 +1,12 @@
+import {
+  PUBLISHABLE_KEY_HEADER,
+  parsePublishableKey,
+  publishableEndpoint,
+  publishableKey
+} from "./chunk-73FXXOAR.js";
+export {
+  PUBLISHABLE_KEY_HEADER,
+  parsePublishableKey,
+  publishableEndpoint,
+  publishableKey
+};

package/dist/server/index.d.ts

@@ -1,8 +1,8 @@
 import { ThreadMeta } from '../protocol.js';
 export { AgentEvent, ChatRequest } from '../protocol.js';
 import { z } from 'zod';
-import { BaseCheckpointSaver } from '@langchain/langgraph';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import { BaseCheckpointSaver } from '@langchain/langgraph';
 
 declare const configSchema: z.ZodObject<{
     spec: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
@@ -65,24 +65,6 @@ interface UrlGuardOptions {
 /** Throws unless `url` is safe to call under the pinned config. */
 declare function assertAllowedUrl(url: string, opts: UrlGuardOptions): URL;
 
-interface KnowledgeSourceInput {
-    id: string;
-    title: string;
-    content: string;
-}
-interface KnowledgeUrlInput {
-    url: string;
-    title?: string;
-}
-interface KnowledgeOptions {
-    sources: KnowledgeSourceInput[];
-    urls: (string | KnowledgeUrlInput)[];
-    topK: number;
-    ttlMs: number;
-    maxSourceBytes: number;
-    maxChunks: number;
-    chunkSize: number;
-}
 interface ChunkMeta {
     sourceId: string;
     title: string;
@@ -109,13 +91,34 @@ declare class MemoryVectorStore implements VectorStore {
     replace(sourceId: string, chunks: StoredChunk[]): Promise<void>;
     search(vector: number[], k: number): Promise<Hit[]>;
 }
+
 /** Splits markdown/plain text into chunks of roughly `size` chars, keeping the nearest heading as context. */
 declare function chunkText(content: string, size: number): string[];
+
 /** Dependency-free HTML to text/markdown-ish conversion. Plain text out; never HTML. */
 declare function htmlToText(html: string): {
     title?: string;
     text: string;
 };
+
+interface KnowledgeSourceInput {
+    id: string;
+    title: string;
+    content: string;
+}
+interface KnowledgeUrlInput {
+    url: string;
+    title?: string;
+}
+interface KnowledgeOptions {
+    sources: KnowledgeSourceInput[];
+    urls: (string | KnowledgeUrlInput)[];
+    topK: number;
+    ttlMs: number;
+    maxSourceBytes: number;
+    maxChunks: number;
+    chunkSize: number;
+}
 interface SourceStatus {
     id: string;
     title: string;
@@ -147,12 +150,33 @@ declare class KnowledgeBase {
     load(): Promise<void>;
     private loadUrls;
     private ingest;
-    private fetchPage;
     /** Re-fetches URL sources. Keeps the old data for any source that fails. Concurrent calls share one run. */
     refresh(): Promise<void>;
     search(query: string): Promise<Hit[]>;
 }
 
+interface DoctorReport {
+    ok: boolean;
+    checks: {
+        name: string;
+        ok: boolean;
+        detail: string;
+    }[];
+    tools: {
+        operationId: string;
+        method: string;
+        path: string;
+        approval: "required" | "auto";
+    }[];
+    knowledge?: {
+        id: string;
+        title: string;
+        url?: string;
+        chunks: number;
+        error?: string;
+    }[];
+}
+
 interface AuditEvent {
     at: number;
     userId: string;
@@ -191,11 +215,13 @@ interface AuthResult {
     /** Headers forwarded to your API (e.g. Authorization, Cookie). Never shown to the LLM. */
     headers?: Record<string, string>;
 }
+
 /** Same shape as LangChain's Embeddings, minimal so any adapter fits. */
 interface EmbeddingsLike {
     embedDocuments(texts: string[]): Promise<number[][]>;
     embedQuery(text: string): Promise<number[]>;
 }
+
 interface CreateAgentOptions extends AgentConfigInput {
     /** Your own chat model (e.g. workersAiChatModel from sideagent/workers-ai). Use instead of `llm`, never with it. It must support bindTools(). */
     model?: BaseChatModel;
@@ -214,27 +240,6 @@ interface CreateAgentOptions extends AgentConfigInput {
     /** Where knowledge embeddings live. Defaults to in-memory (re-embedded on every start). */
     vectorStore?: VectorStore;
 }
-interface DoctorReport {
-    ok: boolean;
-    checks: {
-        name: string;
-        ok: boolean;
-        detail: string;
-    }[];
-    tools: {
-        operationId: string;
-        method: string;
-        path: string;
-        approval: "required" | "auto";
-    }[];
-    knowledge?: {
-        id: string;
-        title: string;
-        url?: string;
-        chunks: number;
-        error?: string;
-    }[];
-}
 declare function createAgent(options: CreateAgentOptions): Promise<{
     handler: (request: Request) => Promise<Response>;
     doctor: () => Promise<DoctorReport>;