@corgelabs/corge 0.0.1 → 1.0.0

package/dist/chat/schema.d.ts

@@ -0,0 +1,285 @@
+import type { FieldValue, Timestamp } from 'firebase-admin/firestore';
+import type { ModelMessage, streamText } from 'ai';
+import { z } from 'zod';
+import type { AttachmentTypesMap } from '../attachments';
+import type { AppBindings, DbRole, RateLimitConfig } from '../config';
+import { type EntryId, type FileRef } from '../db';
+import type { Core } from '../index';
+import type { AuthLevel } from '../router';
+export type VectorValue = ReturnType<typeof FieldValue.vector>;
+export type SystemPromptBuilder = (ctx: {
+    today: string;
+    userId: EntryId;
+    env: AppBindings;
+}) => string | Promise<string>;
+export interface AgentToolPresets {
+    discovery?: string[];
+    workflow?: string[];
+}
+/** Per-user data injected into a chat turn by `AgentConfig.resolveUserContext`. */
+export interface UserContext {
+    /** Compact flags (≤ ~1 KB). Sent to the InfoBase classifier and to the agent. */
+    state: Record<string, unknown>;
+    /** Capped records (≤ ~8 KB). Sent to the agent only, never to the classifier. */
+    details?: Record<string, unknown>;
+}
+export type UserContextResolver = (ctx: {
+    userId: EntryId;
+    core: Core;
+    signal: AbortSignal;
+}) => Promise<UserContext | undefined>;
+export interface AgentConfig {
+    name?: string;
+    description?: string;
+    model?: string;
+    systemPrompt: string | SystemPromptBuilder;
+    tools?: string[];
+    toolPresets?: AgentToolPresets;
+    maxSteps?: number;
+    useContext?: boolean;
+    /** Restricts InfoBase items to those tagged with any of these audiences. Omit for no filtering. */
+    contextAudiences?: readonly string[];
+    /** Loads the caller's own data for each turn. Must honour `signal`; failures degrade to no user context. */
+    resolveUserContext?: UserContextResolver;
+    attachmentTypes?: AttachmentTypesMap;
+    auth?: AuthLevel;
+    rateLimit?: RateLimitConfig;
+    mcp?: boolean;
+}
+export declare const defineAgent: <C extends AgentConfig>(config: C) => C;
+export declare const defineAgents: <T extends Record<string, AgentConfig>>(agents: T) => T;
+export interface ChatMetadataDoc {
+    id: string;
+    userId: string;
+    agentId: string;
+    title: string;
+    model: string;
+    messageCount: number;
+    summary?: string | null;
+    activeGenerationId?: string | null;
+    deleted: boolean;
+    createdAt: Timestamp | Date;
+    updatedAt: Timestamp | Date;
+}
+export type ChatMessageRole = 'user' | 'assistant' | 'system' | 'tool';
+export interface ChatMessageDoc {
+    id: string;
+    chatId: string;
+    userId: string;
+    role: ChatMessageRole;
+    content: string;
+    parts: unknown[];
+    toolInvocations?: unknown[];
+    attachments?: string[];
+    tokenCount?: number;
+    cancelled?: boolean;
+    createdAt: Timestamp | Date;
+    embedding?: VectorValue;
+}
+export type ChatMessagePublic = Omit<ChatMessageDoc, 'embedding' | 'createdAt'> & {
+    createdAt: Date;
+};
+export interface RecalledMemorySnippet {
+    id: string;
+    chatId: string;
+    role: ChatMessageRole;
+    content: string;
+    scope: 'in_chat' | 'cross_chat';
+}
+export interface ContextItemSpec {
+    path: string;
+    description: string;
+    /** Audiences allowed to receive this item (matched against `AgentConfig.contextAudiences`). Omit to expose to every agent. */
+    audiences?: readonly string[];
+}
+export declare const defineContext: <const T extends readonly ContextItemSpec[]>(items: T) => T;
+export interface ContextEntry {
+    path: string;
+    description: string;
+    markdown: string;
+}
+export interface GetContextOptions {
+    maxSources?: number;
+    /** Only items tagged with any of these audiences (or untagged items) are considered. */
+    audiences?: readonly string[];
+    /** Compact caller state forwarded to the classifier to judge relevance. */
+    userState?: Record<string, unknown>;
+}
+export interface DynamicContextBlockInput {
+    currentTimeIso?: string;
+    recalledMemories?: readonly RecalledMemorySnippet[];
+    infobaseContextEntries?: readonly ContextEntry[];
+    stagedAttachmentSummaries?: readonly string[];
+    userContext?: UserContext;
+}
+export interface HybridRetrievalOptions {
+    userId?: EntryId;
+    chatId?: string;
+    messageCount?: number;
+    prompt: string;
+    useContext?: boolean;
+    slidingWindowSize?: number;
+    /** Agent whose `contextAudiences` and `resolveUserContext` scope this turn. */
+    agent?: Pick<AgentConfig, 'contextAudiences' | 'resolveUserContext'>;
+    /** Verified caller role (defaults to `resolveUserRole(userId)`). */
+    role?: DbRole;
+    abortSignal?: AbortSignal;
+}
+export interface HybridRetrievalResult {
+    slidingWindowDocs: ChatMessagePublic[];
+    slidingWindowMessages: ModelMessage[];
+    recalledMemories: RecalledMemorySnippet[];
+    infobaseContextEntries: ContextEntry[];
+    userContext?: UserContext;
+}
+export interface ListChatMessagesOptions {
+    limit?: number;
+    before?: EntryId;
+}
+export interface WorkflowToolSpec {
+    description: string;
+    input: z.ZodType<any>;
+    mcp?: boolean;
+    tool?: boolean;
+    execute: (input: any, userId: EntryId) => Promise<unknown>;
+}
+export interface VerifiedAgentToolContext {
+    core: Core;
+    chatId?: string;
+    abortSignal?: AbortSignal;
+}
+export interface RunAgentOptions {
+    modelOverride?: string;
+    chatId?: string;
+    abortSignal?: AbortSignal;
+    dynamicContext?: DynamicContextBlockInput;
+    core?: Core;
+    onFinish?: Parameters<typeof streamText>[0]['onFinish'];
+}
+export interface AskAgentOptions {
+    userId?: EntryId;
+    includeContext?: boolean;
+    abortSignal?: AbortSignal;
+}
+export declare const ReasoningExpertInputDto: z.ZodObject<{
+    problemStatement: z.ZodString;
+    constraintsAndContext: z.ZodString;
+}, z.core.$strip>;
+export declare const ReasoningExpertOutputDto: z.ZodObject<{
+    analysisSummary: z.ZodString;
+    recommendedSolution: z.ZodString;
+    edgeCasesToWatch: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export interface RawAttachmentPart {
+    dataUrl?: string;
+    ref?: FileRef;
+    filename: string;
+}
+export interface PersistTurnCompletionOpts {
+    turn: ReturnType<typeof import('ai').streamText>;
+    getAccumulatedText: () => string;
+    signal: AbortSignal;
+    userVecPromise: Promise<number[] | null>;
+    chatDocRef: import('firebase-admin/firestore').DocumentReference;
+    chatId: string;
+    userId: EntryId;
+    resolvedAgentId: string;
+    title: string;
+    selectedModel: string;
+    userMsgId: string;
+    assistantMsgId: string;
+    userCreatedAtMs: number;
+    finalUserText: string;
+    userPartsForStorage: unknown[];
+    stagedRefs: FileRef[];
+    unsubCancelWatch: (() => void) | undefined;
+    key: string;
+}
+export declare const chatIdParam: z.ZodObject<{
+    chatId: z.ZodString;
+}, z.core.$strip>;
+export declare const listChatMessagesQuery: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    before: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const saveChatBody: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    chatId: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const streamChatMessageInput: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    role: z.ZodDefault<z.ZodLiteral<"user">>;
+    content: z.ZodOptional<z.ZodString>;
+    parts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type StreamChatMessageInput = z.infer<typeof streamChatMessageInput>;
+export declare const streamChatBody: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    chatId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    message: z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        role: z.ZodDefault<z.ZodLiteral<"user">>;
+        content: z.ZodOptional<z.ZodString>;
+        parts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strict>;
+export declare const openaiMessagePartSchema: z.ZodObject<{
+    type: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+    image_url: z.ZodOptional<z.ZodObject<{
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    file: z.ZodOptional<z.ZodObject<{
+        file_data: z.ZodOptional<z.ZodString>;
+        filename: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+export declare const openaiMessageSchema: z.ZodObject<{
+    role: z.ZodString;
+    content: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        text: z.ZodOptional<z.ZodString>;
+        image_url: z.ZodOptional<z.ZodObject<{
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        file: z.ZodOptional<z.ZodObject<{
+            file_data: z.ZodOptional<z.ZodString>;
+            filename: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$loose>>, z.ZodNull]>>;
+}, z.core.$loose>;
+export declare const openaiCompletionsBody: z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+        content: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            text: z.ZodOptional<z.ZodString>;
+            image_url: z.ZodOptional<z.ZodObject<{
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            file: z.ZodOptional<z.ZodObject<{
+                file_data: z.ZodOptional<z.ZodString>;
+                filename: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$loose>>, z.ZodNull]>>;
+    }, z.core.$loose>>;
+    stream: z.ZodOptional<z.ZodBoolean>;
+    stream_options: z.ZodOptional<z.ZodObject<{
+        include_usage: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export declare const webSearchInput: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/chat/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/chat/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AACrE,OAAO,EAAoB,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAA;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAA;AAE9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,GAAG,EAAE,WAAW,CAAA;CACjB,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;AAE9B,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE;IACtC,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,WAAW,CAAA;CACpB,KAAK,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAA;AAEtC,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,GAAG,mBAAmB,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,gBAAgB,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,4GAA4G;IAC5G,kBAAkB,CAAC,EAAE,mBAAmB,CAAA;IACxC,eAAe,CAAC,EAAE,kBAAkB,CAAA;IACpC,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,WAAW,UAAU,CAAC,KAAG,CAAW,CAAA;AAC1E,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,KAAG,CAAW,CAAA;AAE3F,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEtE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,eAAe,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,EAAE,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;IAC3B,SAAS,CAAC,EAAE,WAAW,CAAA;CACxB;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG;IAChF,SAAS,EAAE,IAAI,CAAA;CAChB,CAAA;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,eAAe,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,GAAG,YAAY,CAAA;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,8HAA8H;IAC9H,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B;AAED,eAAO,MAAM,aAAa,GAAI,KAAK,CAAC,CAAC,SAAS,SAAS,eAAe,EAAE,SAAS,CAAC,KAAG,CAAU,CAAA;AAE/F,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wFAAwF;IACxF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAA;IACnD,sBAAsB,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IAChD,yBAAyB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7C,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,kBAAkB,GAAG,oBAAoB,CAAC,CAAA;IACpE,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,EAAE,iBAAiB,EAAE,CAAA;IACtC,qBAAqB,EAAE,YAAY,EAAE,CAAA;IACrC,gBAAgB,EAAE,qBAAqB,EAAE,CAAA;IACzC,sBAAsB,EAAE,YAAY,EAAE,CAAA;IACtC,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACrB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC3D;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,cAAc,CAAC,EAAE,wBAAwB,CAAA;IACzC,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,QAAQ,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;CACxD;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;iBAInC,CAAA;AAEF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,UAAU,CAAC,cAAc,IAAI,EAAE,UAAU,CAAC,CAAA;IAChD,kBAAkB,EAAE,MAAM,MAAM,CAAA;IAChC,MAAM,EAAE,WAAW,CAAA;IACnB,cAAc,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAA;IACxC,UAAU,EAAE,OAAO,0BAA0B,EAAE,iBAAiB,CAAA;IAChE,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,mBAAmB,EAAE,OAAO,EAAE,CAAA;IAC9B,UAAU,EAAE,OAAO,EAAE,CAAA;IACrB,gBAAgB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;IAC1C,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,eAAO,MAAM,WAAW;;iBAAgC,CAAA;AAExD,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAA;AAEF,eAAO,MAAM,YAAY;;;;;;;kBASd,CAAA;AAEX,eAAO,MAAM,sBAAsB;;;;;;iBAMjC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,eAAO,MAAM,cAAc;;;;;;;;;;;;;kBAShB,CAAA;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;iBAOpB,CAAA;AAEhB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;iBAKhB,CAAA;AAEhB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;iBAQlB,CAAA;AAEhB,eAAO,MAAM,cAAc;;;iBAGzB,CAAA"}

package/dist/chat/schema.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { entryId, fileRef } from '../db';
+export const defineAgent = (config) => config;
+export const defineAgents = (agents) => agents;
+export const defineContext = (items) => items;
+export const ReasoningExpertInputDto = z.object({
+    problemStatement: z.string().describe('Self-contained specification of the complex reasoning task.'),
+    constraintsAndContext: z.string().describe('Compact summary of relevant data, constraints, or document fields.')
+});
+export const ReasoningExpertOutputDto = z.object({
+    analysisSummary: z.string(),
+    recommendedSolution: z.string(),
+    edgeCasesToWatch: z.array(z.string())
+});
+export const chatIdParam = z.object({ chatId: entryId });
+export const listChatMessagesQuery = z.object({
+    limit: z.coerce.number().int().min(1).max(200).optional(),
+    before: entryId.optional()
+});
+export const saveChatBody = z
+    .object({
+    id: entryId.optional(),
+    chatId: entryId.optional(),
+    title: z.string().min(1).max(256).optional(),
+    agentId: z.string().min(1).max(128).optional(),
+    model: z.string().min(1).max(128).optional(),
+    summary: z.string().max(4000).nullable().optional()
+})
+    .strict();
+export const streamChatMessageInput = z.object({
+    id: entryId.optional(),
+    role: z.literal('user').default('user'),
+    content: z.string().optional(),
+    parts: z.array(z.record(z.string(), z.unknown())).optional(),
+    attachments: z.array(fileRef).max(20).optional()
+});
+export const streamChatBody = z
+    .object({
+    id: entryId.optional(),
+    chatId: entryId.optional(),
+    agentId: z.string().min(1).max(128).optional(),
+    title: z.string().max(256).optional(),
+    model: z.string().max(128).optional(),
+    message: streamChatMessageInput
+})
+    .strict();
+export const openaiMessagePartSchema = z
+    .object({
+    type: z.string(),
+    text: z.string().optional(),
+    image_url: z.object({ url: z.string().optional() }).optional(),
+    file: z.object({ file_data: z.string().optional(), filename: z.string().optional() }).optional()
+})
+    .passthrough();
+export const openaiMessageSchema = z
+    .object({
+    role: z.string(),
+    content: z.union([z.string(), z.array(openaiMessagePartSchema), z.null()]).optional()
+})
+    .passthrough();
+export const openaiCompletionsBody = z
+    .object({
+    model: z.string(),
+    messages: z.array(openaiMessageSchema).min(1).max(500),
+    stream: z.boolean().optional(),
+    stream_options: z.object({ include_usage: z.boolean().optional() }).optional()
+})
+    .extend({ model: z.string().optional() })
+    .passthrough();
+export const webSearchInput = z.object({
+    query: z.string().min(1).optional(),
+    url: z.string().optional().describe('Full URL to open and read — wins over query')
+});
+//# sourceMappingURL=schema.js.map

package/dist/chat/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/chat/schema.ts"],"names":[],"mappings":"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"}

package/dist/chat/service.d.ts

@@ -0,0 +1,64 @@
+import { streamText, type ModelMessage, type ToolSet } from 'ai';
+import type { EntryId } from '../db';
+import { Core } from '../index';
+import { type AgentConfig, type AskAgentOptions, type ChatMessagePublic, type ContextEntry, type ContextItemSpec, type GetContextOptions, type HybridRetrievalOptions, type HybridRetrievalResult, type ListChatMessagesOptions, type RunAgentOptions, type WorkflowToolSpec } from './schema';
+export declare class ChatService {
+    #private;
+    constructor(coreClient: Core);
+    getContext: (prompt: string, catalog?: readonly ContextItemSpec[], options?: GetContextOptions) => Promise<ContextEntry[]>;
+    retrieveContext: (opts: HybridRetrievalOptions) => Promise<HybridRetrievalResult>;
+    messages: (chatId: EntryId, opts?: ListChatMessagesOptions) => Promise<ChatMessagePublic[]>;
+    cancel: (chatId: EntryId) => Promise<{
+        chatId: string;
+        cancelled: true;
+    }>;
+    stream: (agent: AgentConfig, messages: ModelMessage[], userId?: EntryId, opts?: RunAgentOptions) => Promise<ReturnType<typeof streamText>>;
+    ask: (agentOrId: string | AgentConfig, prompt: string | ModelMessage[], options?: AskAgentOptions) => Promise<{
+        text: string;
+        messages: ModelMessage[];
+    }>;
+    get internals(): {
+        registerWorkflowTool: (name: string, spec: WorkflowToolSpec) => void;
+        clearWorkflowTools: () => void;
+        getMcpTools: () => Map<string, WorkflowToolSpec>;
+        registerAgents: (defs: Record<string, AgentConfig>, reset?: boolean) => void;
+        getRegisteredAgents: () => Record<string, AgentConfig>;
+        getAgentRegistry: () => Map<string, AgentConfig>;
+        registerContextCatalog: (items?: readonly ContextItemSpec[], reset?: boolean) => void;
+        enforceAgentAccess: (c: import("hono").Context<import("../config").AppEnv>, agent: AgentConfig, scopeKey: string) => Promise<void>;
+        stageAndScanAttachments: (userId: EntryId, parts: import("./schema").RawAttachmentPart[], types?: import("../attachments").AttachmentTypesMap) => Promise<{
+            staged: {
+                ref: import("../db").FileRef;
+                filename: string;
+            }[];
+            attachments: import("../attachments").ProcessedAttachment[];
+        }>;
+        startChatStreamTurn: (opts: {
+            userId: EntryId;
+            role: import("../config").DbRole;
+            agent: AgentConfig;
+            attachmentParts: import("./schema").RawAttachmentPart[];
+            rawUserText: string;
+            signal: AbortSignal;
+            chatId?: string;
+            messageCount?: number;
+            selectedModel?: string;
+            priorMessages?: ModelMessage[];
+        }) => Promise<{
+            turn: import("ai").StreamTextResult<ToolSet, import("@ai-sdk/provider-utils").Context, import("ai").OutputInterface<any, any, any>>;
+            stagedRefs: string[];
+            stagedAttachmentSummaries: string[];
+            userCreatedAtMs: number;
+        }>;
+        saveChat: ({ userId, input }: {
+            userId?: EntryId;
+            input: import("zod").infer<typeof import("./schema").saveChatBody>;
+        }) => Promise<import("../db").SelectModel<'chat'>>;
+        streamChatSse: ({ c, userId, input }: {
+            c: import("hono").Context<import("../config").AppEnv>;
+            userId?: EntryId;
+            input?: import("zod").infer<typeof import("./schema").streamChatBody>;
+        }) => Promise<Response>;
+    };
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/chat/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/chat/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EAEV,KAAK,YAAY,EAEjB,KAAK,OAAO,EACb,MAAM,IAAI,CAAA;AAGX,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAE/B,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EAEpB,KAAK,gBAAgB,EACtB,MAAM,UAAU,CAAA;AAajB,qBAAa,WAAW;;IAKtB,YAAY,UAAU,EAAE,IAAI,EAI3B;IAiCD,UAAU,WACA,MAAM,YACJ,SAAS,eAAe,EAAE,YAC1B,iBAAiB,KAC1B,OAAO,CAAC,YAAY,EAAE,CAAC,CAA4D;IAEtF,eAAe,SAAU,sBAAsB,KAAG,OAAO,CAAC,qBAAqB,CAAC,CACrC;IAE3C,QAAQ,WAAY,OAAO,SAAS,uBAAuB,KAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAC/C;IAE3C,MAAM,WAAY,OAAO,KAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC,CACrC;IA+HnC,MAAM,UACG,WAAW,YACR,YAAY,EAAE,WAChB,OAAO,SACR,eAAe,KACrB,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAyExC;IAED,GAAG,cACU,MAAM,GAAG,WAAW,UACvB,MAAM,GAAG,YAAY,EAAE,YACrB,eAAe,KACxB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAiCrD;IAED,IAAI,SAAS;QAET,oBAAoB,SApSO,MAAM,QAAQ,gBAAgB,KAAG,IAAI;QAqShE,kBAAkB,QA5RI,IAAI;QA6R1B,WAAW,QAzRI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC;QA0R5C,cAAc,SAvRO,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,sBAAkB,IAAI;QAwRtE,mBAAmB,QA7QI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;QA8QlD,gBAAgB,QA5QI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;QA6Q5C,sBAAsB;QACtB,kBAAkB;QAClB,uBAAuB;;;;;;;QACvB,mBAAmB;;;;;;;;;;;;;;;;;QACnB,QAAQ;;;;QACR,aAAa;;;;;MAEhB;CACF"}