@pikku/core 0.12.84 → 0.12.86

package/tsconfig.type-tests.json

@@ -7,6 +7,7 @@
     "declarationMap": false
   },
   "files": [
-    "src/secret-value.test.ts"
+    "src/classification/secret-value.test.ts",
+    "src/types/typed-credentials.test.ts"
   ]
-}
+}

package/dist/ecosystem/ai-agent.d.ts

@@ -1,18 +0,0 @@
-export { agent, agentApprove, agentResume, agentStream, } from '../wirings/ai-agent/ai-agent-helpers.js';
-export { resolveModelAlias } from '../wirings/ai-agent/ai-agent-model-config.js';
-export { canAccessThread, isOwnedByPrincipal, threadOwnerConstraint, } from '../wirings/ai-agent/ai-agent-prepare.js';
-export { addAIAgent } from '../wirings/ai-agent/ai-agent-registry.js';
-export type { AIAgentInput, AIAgentMemoryConfig, AIAgentMeta, AIAgentStep, AIContentPart, AgentRunRow, AgentRunService, CoreAIAgent, PendingApproval, PikkuAIMiddlewareHooks, } from '../wirings/ai-agent/ai-agent.types.js';
-export { voiceInput } from '../wirings/ai-agent/voice-input.js';
-export { voiceOutput } from '../wirings/ai-agent/voice-output.js';
-/**
- * Types the exports above mention but do not themselves export. Without
- * them a consumer's declaration emit has no name for the type it infers,
- * and fails with TS2883 rather than reaching for the original entry point.
- */
-export type { LogLevel } from '../services/logger.js';
-export type { WebhookServiceConfig } from '../services/webhook-service.js';
-export type { CoreSingletonServices, PostgresConfig, } from '../types/core.types.js';
-export type { SpeakableScripts } from '../wirings/ai-agent/voice-output.js';
-export type { WorkflowServiceConfig } from '../wirings/workflow/workflow.types.js';
-export type { VoiceOutputState } from '../wirings/ai-agent/voice-output.js';

package/dist/ecosystem/ai-agent.js

@@ -1,6 +0,0 @@
-export { agent, agentApprove, agentResume, agentStream, } from '../wirings/ai-agent/ai-agent-helpers.js';
-export { resolveModelAlias } from '../wirings/ai-agent/ai-agent-model-config.js';
-export { canAccessThread, isOwnedByPrincipal, threadOwnerConstraint, } from '../wirings/ai-agent/ai-agent-prepare.js';
-export { addAIAgent } from '../wirings/ai-agent/ai-agent-registry.js';
-export { voiceInput } from '../wirings/ai-agent/voice-input.js';
-export { voiceOutput } from '../wirings/ai-agent/voice-output.js';

package/dist/ecosystem/ai-scorer.d.ts

@@ -1,12 +0,0 @@
-export { gradeRun } from '../wirings/ai-scorer/ai-scorer-grade.js';
-export { addAIScorer } from '../wirings/ai-scorer/ai-scorer-registry.js';
-export { enableScoreSnapshots, getScoreSnapshot, } from '../wirings/ai-scorer/ai-scorer-snapshots.js';
-export { wireAIScorerQueueWorkers } from '../wirings/ai-scorer/ai-scorer-worker.js';
-export { pikkuAIJudge, pikkuAIScorer } from '../wirings/ai-scorer/ai-scorer.js';
-export type { ScorerMeta } from '../wirings/ai-scorer/ai-scorer.types.js';
-/**
- * Types the exports above mention but do not themselves export. Without
- * them a consumer's declaration emit has no name for the type it infers,
- * and fails with TS2883 rather than reaching for the original entry point.
- */
-export type { PikkuAIScorer, ScoreJob, ScorerInput, ScorerOutput, } from '../wirings/ai-scorer/ai-scorer.types.js';

package/dist/ecosystem/ai-scorer.js

@@ -1,5 +0,0 @@
-export { gradeRun } from '../wirings/ai-scorer/ai-scorer-grade.js';
-export { addAIScorer } from '../wirings/ai-scorer/ai-scorer-registry.js';
-export { enableScoreSnapshots, getScoreSnapshot, } from '../wirings/ai-scorer/ai-scorer-snapshots.js';
-export { wireAIScorerQueueWorkers } from '../wirings/ai-scorer/ai-scorer-worker.js';
-export { pikkuAIJudge, pikkuAIScorer } from '../wirings/ai-scorer/ai-scorer.js';

package/dist/services/ai-agent-runner-service.d.ts

@@ -1,220 +0,0 @@
-import type { AIMessage, AIAgentStep, AIAgentToolDef, AIStreamChannel } from '../wirings/ai-agent/ai-agent.types.js';
-export type AIProviderOptions = Record<string, Record<string, unknown>>;
-export type AIAgentRunnerParams = {
-    model: string;
-    temperature?: number;
-    instructions: string;
-    messages: AIMessage[];
-    tools: AIAgentToolDef[];
-    maxSteps: number;
-    toolChoice: 'auto' | 'required' | 'none';
-    outputSchema?: Record<string, unknown>;
-    /** Pikku agent function name — forwarded to the LLM proxy (LiteLLM) as
-     *  request-level metadata so usage can be broken down per agent. */
-    agentId?: string;
-    /**
-     * Cancels the model call itself, not just delivery of its output. Set by
-     * `streamAIAgent` from the run's interrupt handle so a voice barge-in stops
-     * generation upstream rather than leaving tokens being billed into a stream
-     * nobody reads. A runner that ignores it degrades to "the caller stops
-     * listening", which is the behaviour before this field existed.
-     */
-    abortSignal?: AbortSignal;
-    /**
-     * Per-provider settings passed to the model untouched — the escape hatch for
-     * anything the shared params above cannot express because only one vendor
-     * has it.
-     *
-     * The setting that motivated it is `reasoningEffort`. A voice turn is heard
-     * rather than read, so the wait before the first word is most of the
-     * experience: `{ openai: { reasoningEffort: 'minimal' } }` on gpt-5-mini
-     * measured 0.9s to first token against 2.5s at the default, and 1.6s of
-     * silence is a long time to sit through having just finished speaking.
-     */
-    providerOptions?: AIProviderOptions;
-};
-export type AIAgentRunnerResult = {
-    text: string;
-    object?: unknown;
-    steps: AIAgentStep[];
-    usage: {
-        inputTokens: number;
-        outputTokens: number;
-    };
-};
-export type AIAgentStepResult = {
-    text: string;
-    object?: unknown;
-    toolCalls: {
-        toolCallId: string;
-        toolName: string;
-        args: unknown;
-    }[];
-    toolResults: {
-        toolCallId: string;
-        toolName: string;
-        result: unknown;
-        /**
-         * Set when the tool threw rather than returned. Carried as its own field
-         * because `result` is a rendered string by the time anything downstream
-         * reads it, and "did this tool fail" is not answerable by looking for an
-         * `Error:` prefix in text a tool could legitimately have returned.
-         */
-        error?: string;
-    }[];
-    usage: {
-        inputTokens: number;
-        outputTokens: number;
-    };
-    finishReason: 'stop' | 'tool-calls' | 'length' | 'error' | 'unknown';
-    reasoningContent?: string;
-};
-export type AITranscriptionParams = {
-    model: string;
-    audio: Uint8Array;
-    providerOptions?: AIProviderOptions;
-    maxRetries?: number;
-    abortSignal?: AbortSignal;
-    headers?: Record<string, string>;
-};
-export type AITranscriptionResult = {
-    text: string;
-    segments?: Array<{
-        text: string;
-        startSecond: number;
-        endSecond: number;
-    }>;
-    language?: string;
-    durationInSeconds?: number;
-    warnings?: unknown[];
-    providerMetadata?: Record<string, unknown>;
-    responses?: unknown[];
-};
-export type AIGenerateSpeechParams = {
-    model: string;
-    text: string;
-    voice?: string;
-    outputFormat?: string;
-    instructions?: string;
-    speed?: number;
-    language?: string;
-    providerOptions?: AIProviderOptions;
-    maxRetries?: number;
-    abortSignal?: AbortSignal;
-    headers?: Record<string, string>;
-};
-export type AIGenerateSpeechResult = {
-    audio: {
-        uint8Array: Uint8Array;
-        base64: string;
-        mediaType: string;
-        format: string;
-    };
-    warnings?: unknown[];
-    providerMetadata?: Record<string, unknown>;
-    responses?: unknown[];
-};
-export type AIGenerateImagePrompt = string | {
-    images: Array<Uint8Array | ArrayBuffer | string>;
-    text?: string;
-    mask?: Uint8Array | ArrayBuffer | string;
-};
-export type AIGenerateImageParams = {
-    model: string;
-    prompt: AIGenerateImagePrompt;
-    n?: number;
-    maxImagesPerCall?: number;
-    size?: `${number}x${number}`;
-    aspectRatio?: `${number}:${number}`;
-    seed?: number;
-    providerOptions?: AIProviderOptions;
-    maxRetries?: number;
-    abortSignal?: AbortSignal;
-    headers?: Record<string, string>;
-};
-export type AIGenerateImageResult = {
-    images: Array<{
-        uint8Array: Uint8Array;
-        base64: string;
-        mediaType: string;
-    }>;
-    warnings?: unknown[];
-    providerMetadata?: Record<string, unknown>;
-    responses?: unknown[];
-    usage?: {
-        inputTokens?: number;
-        outputTokens?: number;
-        totalTokens?: number;
-    };
-};
-export type AIEmbedParams = {
-    model: string;
-    value: string;
-    providerOptions?: AIProviderOptions;
-    maxRetries?: number;
-    abortSignal?: AbortSignal;
-    headers?: Record<string, string>;
-};
-export type AIEmbedResult = {
-    value: string;
-    embedding: number[];
-    usage?: {
-        tokens?: number;
-    };
-    warnings?: unknown[];
-    providerMetadata?: Record<string, unknown>;
-    response?: unknown;
-};
-export type AIEmbedManyParams = {
-    model: string;
-    values: string[];
-    providerOptions?: AIProviderOptions;
-    maxRetries?: number;
-    abortSignal?: AbortSignal;
-    headers?: Record<string, string>;
-    maxParallelCalls?: number;
-};
-export type AIEmbedManyResult = {
-    values: string[];
-    embeddings: number[][];
-    usage?: {
-        tokens?: number;
-    };
-    warnings?: unknown[];
-    providerMetadata?: Record<string, unknown>;
-    responses?: unknown[];
-};
-export type AIRerankParams<VALUE extends string | Record<string, unknown>> = {
-    model: string;
-    query: string;
-    documents: VALUE[];
-    topK?: number;
-    providerOptions?: AIProviderOptions;
-    maxRetries?: number;
-    abortSignal?: AbortSignal;
-    headers?: Record<string, string>;
-};
-export type AIRerankResult<VALUE extends string | Record<string, unknown>> = {
-    ranking: Array<{
-        index: number;
-        document: VALUE;
-        score: number;
-    }>;
-    rerankedDocuments: VALUE[];
-    originalDocuments: VALUE[];
-    providerMetadata?: Record<string, unknown>;
-    response?: unknown;
-};
-export interface AIAgentRunnerService {
-    stream(params: AIAgentRunnerParams, channel: AIStreamChannel): Promise<AIAgentStepResult>;
-    run(params: AIAgentRunnerParams): Promise<AIAgentStepResult>;
-    transcribe?(params: AITranscriptionParams): Promise<AITranscriptionResult>;
-    generateSpeech?(params: AIGenerateSpeechParams): Promise<AIGenerateSpeechResult>;
-    generateImage?(params: AIGenerateImageParams): Promise<AIGenerateImageResult>;
-    embed?(params: AIEmbedParams): Promise<AIEmbedResult>;
-    embedMany?(params: AIEmbedManyParams): Promise<AIEmbedManyResult>;
-    rerank?<VALUE extends string | Record<string, unknown>>(params: AIRerankParams<VALUE>): Promise<AIRerankResult<VALUE>>;
-    /** Return a new runner that uses the given API key for every LLM call.
-     *  Optional — runners that don't support per-key scoping leave this undefined. */
-    withApiKey?(apiKey: string): AIAgentRunnerService;
-}

package/dist/services/ai-run-state-service.d.ts

@@ -1,29 +0,0 @@
-import type { AgentRunState, PendingApproval } from '../wirings/ai-agent/ai-agent.types.js';
-import type { AIRunScore } from '../wirings/ai-scorer/ai-scorer.types.js';
-export type CreateRunInput = Omit<AgentRunState, 'runId'>;
-export type SaveScoreInput = Omit<AIRunScore, 'createdAt'>;
-export interface AIRunStateService {
-    createRun(run: CreateRunInput): Promise<string>;
-    updateRun(runId: string, updates: Partial<AgentRunState>): Promise<void>;
-    getRun(runId: string): Promise<AgentRunState | null>;
-    getRunsByThread(threadId: string): Promise<AgentRunState[]>;
-    /**
-     * Claims an approval: removes it from the run's pending list and records the
-     * decision, as one atomic step. Returns whether THIS caller made the claim —
-     * concurrent approvals of the same tool call produce exactly one `true`, and
-     * only that caller may run the tool.
-     */
-    resolveApproval(toolCallId: string, status: 'approved' | 'denied'): Promise<boolean>;
-    findRunByToolCallId(toolCallId: string): Promise<{
-        run: AgentRunState;
-        approval: PendingApproval;
-    } | null>;
-    /**
-     * Record one scorer's grade of a finished run. A run accumulates one row per
-     * scorer, and a scorer may grade the same run more than once — a retried job
-     * appends rather than replaces, so a re-grade never silently overwrites the
-     * grade that was acted on.
-     */
-    saveScore(score: SaveScoreInput): Promise<void>;
-    getScores(runId: string): Promise<AIRunScore[]>;
-}

package/dist/services/ai-storage-service.d.ts

@@ -1,18 +0,0 @@
-import type { AIThread, AIMessage } from '../wirings/ai-agent/ai-agent.types.js';
-export interface AIStorageService {
-    createThread(resourceId: string, options?: {
-        threadId?: string;
-        title?: string;
-        metadata?: Record<string, unknown>;
-    }): Promise<AIThread>;
-    getThread(threadId: string): Promise<AIThread>;
-    getThreads(resourceId: string): Promise<AIThread[]>;
-    deleteThread(threadId: string): Promise<void>;
-    getMessages(threadId: string, options?: {
-        lastN?: number;
-        cursor?: string;
-    }): Promise<AIMessage[]>;
-    saveMessages(threadId: string, messages: AIMessage[]): Promise<void>;
-    getWorkingMemory(id: string, scope: 'resource' | 'thread'): Promise<Record<string, unknown> | null>;
-    saveWorkingMemory(id: string, scope: 'resource' | 'thread', data: Record<string, unknown>): Promise<void>;
-}

package/dist/services/in-memory-ai-run-state-service.d.ts

@@ -1,19 +0,0 @@
-import type { AIRunStateService, CreateRunInput, SaveScoreInput } from './ai-run-state-service.js';
-import type { AgentRunState, PendingApproval } from '../wirings/ai-agent/ai-agent.types.js';
-import type { AIRunScore } from '../wirings/ai-scorer/ai-scorer.types.js';
-export declare class InMemoryAIRunStateService implements AIRunStateService {
-    private runs;
-    private scores;
-    private counter;
-    createRun(run: CreateRunInput): Promise<string>;
-    updateRun(runId: string, updates: Partial<AgentRunState>): Promise<void>;
-    getRun(runId: string): Promise<AgentRunState | null>;
-    getRunsByThread(threadId: string): Promise<AgentRunState[]>;
-    resolveApproval(toolCallId: string, status: 'approved' | 'denied'): Promise<boolean>;
-    findRunByToolCallId(toolCallId: string): Promise<{
-        run: AgentRunState;
-        approval: PendingApproval;
-    } | null>;
-    saveScore(score: SaveScoreInput): Promise<void>;
-    getScores(runId: string): Promise<AIRunScore[]>;
-}

package/dist/services/in-memory-ai-run-state-service.js

@@ -1,54 +0,0 @@
-export class InMemoryAIRunStateService {
-    runs = new Map();
-    scores = new Map();
-    counter = 0;
-    async createRun(run) {
-        const runId = `run-${++this.counter}-${Date.now()}`;
-        this.runs.set(runId, { ...run, runId });
-        return runId;
-    }
-    async updateRun(runId, updates) {
-        const run = this.runs.get(runId);
-        if (run) {
-            Object.assign(run, updates, { updatedAt: new Date() });
-        }
-    }
-    async getRun(runId) {
-        return this.runs.get(runId) ?? null;
-    }
-    async getRunsByThread(threadId) {
-        return [...this.runs.values()].filter((r) => r.threadId === threadId);
-    }
-    async resolveApproval(toolCallId, status) {
-        for (const run of this.runs.values()) {
-            if (run.pendingApprovals) {
-                const approval = run.pendingApprovals.find((a) => a.toolCallId === toolCallId);
-                if (approval) {
-                    run.pendingApprovals = run.pendingApprovals.filter((a) => a.toolCallId !== toolCallId);
-                    run.updatedAt = new Date();
-                    return true;
-                }
-            }
-        }
-        return false;
-    }
-    async findRunByToolCallId(toolCallId) {
-        for (const run of this.runs.values()) {
-            if (run.pendingApprovals) {
-                const approval = run.pendingApprovals.find((a) => a.toolCallId === toolCallId);
-                if (approval) {
-                    return { run, approval };
-                }
-            }
-        }
-        return null;
-    }
-    async saveScore(score) {
-        const existing = this.scores.get(score.runId) ?? [];
-        existing.push({ ...score, createdAt: new Date() });
-        this.scores.set(score.runId, existing);
-    }
-    async getScores(runId) {
-        return [...(this.scores.get(runId) ?? [])];
-    }
-}

package/dist/testing/service-tests/ai-storage-service-tests.d.ts

@@ -1,3 +0,0 @@
-import type { ServiceTestConfig } from '../service-tests.js';
-/** Conformance suite for `aiStorageService`. Runs only when a backend supplies one. */
-export declare const defineAiStorageServiceTests: (name: string, aiStorageService: NonNullable<ServiceTestConfig["services"]["aiStorageService"]>) => void;