dsh-mnemon 0.1.0

package/lib/types/contracts.d.ts

@@ -0,0 +1,272 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** Plugin RPC failures use only error branches accepted by DSH's closed wire schema. */
+export type RpcError = {
+    code: 'bad-request';
+    message: string;
+    details: {
+        issues: JsonValue[];
+    };
+} | {
+    code: 'settings-rejected';
+    message: string;
+    details: {
+        ns: string;
+    };
+} | {
+    code: 'internal';
+    message: string;
+    details: Record<string, never>;
+};
+export type RpcResult<T = JsonValue> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: RpcError;
+};
+export interface ClientConnectionHandle {
+    rpc: {
+        call(channel: string, endpoint: string, payload: unknown): Promise<RpcResult<unknown>>;
+    };
+}
+export type HostRpcHandler = (endpoint: string, payload: unknown) => Promise<RpcResult<unknown>>;
+export interface HostConnectionHandle {
+    rpc: {
+        handle(channel: string, handler: HostRpcHandler, options: {
+            authority: 'trusted-host' | 'loopback';
+        }): unknown;
+    };
+}
+export interface HostSettingsScope<T> {
+    get(): T;
+}
+export interface HostSettingsService {
+    readonly writable: boolean;
+    register<T>(namespace: string, schema: unknown, options: {
+        base?: Partial<T>;
+        applies: 'live' | 'restart';
+        validate?: (value: T) => void;
+    }): HostSettingsScope<T>;
+    describe(options?: {
+        redactSecrets?: boolean;
+    }): Array<{
+        ns: string;
+        value: unknown;
+        base?: unknown;
+        user?: unknown;
+        revision: number;
+        applies: 'live' | 'restart';
+    }>;
+    mutate(namespace: string, ops: Array<{
+        op: 'set';
+        path: string[];
+        value: unknown;
+    } | {
+        op: 'unset';
+        path: string[];
+    }>, expectedRevision?: number): Promise<void>;
+}
+export interface ToolExecution {
+    signal: AbortSignal;
+    agent?: HostAgent;
+}
+export type CommandResult = {
+    kind: 'success';
+    text?: string;
+} | {
+    kind: 'error';
+    text: string;
+};
+export interface CommandInvocation {
+    agent: HostAgent;
+    rawInput: string;
+    signal: AbortSignal;
+}
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    input?: {
+        hint: string;
+    };
+    handler(invocation: CommandInvocation): CommandResult | Promise<CommandResult>;
+}
+export interface CommandService {
+    register(definition: CommandDefinition): unknown;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    output: {
+        schema: Record<string, unknown>;
+        render: (args: Record<string, unknown>, value: never) => Array<{
+            type: 'text';
+            text: string;
+        }>;
+    };
+    execute: (args: never, execution: ToolExecution) => Promise<unknown>;
+    presentCall?: (args: never) => Record<string, unknown>;
+    presentResult?: () => Record<string, unknown>;
+}
+export interface HostMessageSource {
+    kind: string;
+    plugin?: string;
+    form?: string;
+    summary?: string;
+}
+export interface HostUserMessage {
+    id: string;
+    role: 'user';
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    source: HostMessageSource;
+}
+export interface HostSessionEvent {
+    type: string;
+    seq?: number;
+    time?: number;
+    data: Record<string, unknown>;
+}
+export type HostPreStepDecision = {
+    kind: 'reject';
+} | {
+    kind: 'enter';
+    messages: HostUserMessage[];
+};
+export interface HostAgentContext {
+    on(name: string, listener: (...args: never[]) => unknown): () => unknown;
+    effect(callback: () => (() => unknown) | void, label?: string): () => unknown;
+}
+export interface HostAgent {
+    id: string;
+    status: 'idle' | 'running';
+    options?: {
+        provider?: string;
+        model?: string;
+        maxTokens?: number;
+    };
+    session: {
+        header?: {
+            origin?: 'subagent';
+            delegationDepth?: number;
+            cwd?: string;
+        };
+        events: readonly HostSessionEvent[];
+    };
+    ctx: HostAgentContext;
+    followup(message: HostUserMessage): void;
+    steer(message: HostUserMessage): void;
+    inject(message: HostUserMessage): void;
+}
+export interface HostAgentsService {
+    get(id: string): HostAgent | undefined;
+    roots(): HostAgent[];
+}
+export interface HostSubagentResult {
+    output: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    structured?: unknown;
+    stopReason: string;
+}
+export interface HostSubagentRun {
+    id: string;
+    localAgent?: HostAgent;
+    result: Promise<HostSubagentResult>;
+    dispose(): Promise<void>;
+}
+export interface HostSubagentProvider {
+    inheritsParentContext?: boolean;
+    capabilities: {
+        outputSchema: boolean;
+        depthLimit: boolean;
+        toolFilter: boolean;
+        persona: boolean;
+    };
+}
+export interface HostSubagentsService {
+    list(): string[];
+    getProvider(name: string): HostSubagentProvider | undefined;
+    start(name: string, request: {
+        label?: string;
+        prompt: Array<{
+            type: 'text';
+            text: string;
+        }>;
+        parent: HostAgent;
+        signal: AbortSignal;
+        agentOptions?: {
+            provider?: string;
+            model?: string;
+            maxTokens?: number;
+        };
+        outputSchema?: Record<string, unknown>;
+        maxDepth?: number;
+        toolFilter?: {
+            allow?: string[];
+            deny?: string[];
+        };
+        persona?: string;
+    }): Promise<HostSubagentRun>;
+}
+export interface HostContextShape {
+    tools: {
+        register(definition: ToolDefinition): unknown;
+    };
+    commands: CommandService;
+    settings: HostSettingsService;
+    connection: HostConnectionHandle;
+    agents: HostAgentsService;
+    subagents: HostSubagentsService;
+    get(name: string): unknown;
+    inject(services: string[], callback: (ctx: HostContextShape) => void): unknown;
+    on(name: string, listener: (...args: never[]) => unknown): () => unknown;
+    effect(callback: () => (() => unknown) | void, label?: string): () => unknown;
+}
+export interface SlotsService {
+    inject(name: string, factory: () => unknown): unknown;
+    register(options: {
+        name: string;
+        id: string;
+        order?: number;
+        label?: string | (() => string);
+        locale?: string;
+        inject?: () => Record<string, unknown>;
+    }, component: (props: never) => unknown): unknown;
+}
+export interface ClientLocaleService {
+    register(namespace: string, dictionaries: {
+        zh: Record<string, string>;
+        en: Record<string, string>;
+    }): () => void;
+    bind(namespace: string): (key: string, params?: Record<string, unknown>) => string;
+}
+export interface ClientSettingsSnapshot<T> {
+    status: 'loading' | 'ready' | 'unavailable';
+    value?: T;
+    base?: unknown;
+    user?: unknown;
+    revision?: number;
+    writable: boolean;
+    mode: 'host' | 'memory';
+}
+export interface ClientSettingsScope<T> {
+    getSnapshot(): ClientSettingsSnapshot<T>;
+    subscribe(listener: () => void): () => void;
+    set(field: string, value: unknown): Promise<void>;
+    unset(field: string): Promise<void>;
+}
+export interface ClientContextShape {
+    slots: SlotsService;
+    connection: ClientConnectionHandle;
+    locale: ClientLocaleService;
+    effect(callback: () => (() => unknown) | void, label?: string): () => unknown;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/lib/types/contracts.d.ts.map

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

package/lib/types/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/lib/types/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/contracts.ts"],"names":[],"mappings":""}

package/lib/types/documents.d.ts

@@ -0,0 +1,149 @@
+import type { HostAgent } from './contracts.ts';
+export declare const DOCUMENTS_VERSION = 1;
+export declare const DOCUMENTS_ACTIVE_LIMIT_BYTES: number;
+export type DocumentStatus = 'active' | 'archived';
+export interface DocumentRecord {
+    id: string;
+    title: string;
+    description: string;
+    status: DocumentStatus;
+    filename: string;
+    relativePath: string;
+    sourcePaths: string[];
+    sessionIds: string[];
+    createdAt: string;
+    updatedAt: string;
+    lastAccessedAt: string;
+    revision: number;
+    contentHash: string;
+    sizeBytes: number;
+    archivedAt?: string;
+    archiveSummary?: string;
+    memoryBodyIds: string[];
+}
+export interface DocumentView extends DocumentRecord {
+    content: string;
+}
+export interface DocumentSnapshot {
+    workspaceRoot: string;
+    directory: string;
+    indexPath: string;
+    generatedAt: string;
+    revision: string;
+    limitBytes: number;
+    activeBytes: number;
+    activeCount: number;
+    archivedCount: number;
+    total: number;
+    documents: Array<DocumentRecord & {
+        healthy: boolean;
+        excerpt: string;
+    }>;
+}
+export interface DocumentSearchResult {
+    query: string;
+    includeArchived: boolean;
+    total: number;
+    generatedAt: string;
+    results: Array<DocumentView & {
+        score: number;
+        excerpt: string;
+    }>;
+}
+export type DocumentMutation = {
+    action: 'create';
+    title: string;
+    description?: string;
+    content: string;
+    sourcePaths?: string[];
+    sessionIds?: string[];
+} | {
+    action: 'update';
+    id: string;
+    title?: string;
+    description?: string;
+    content?: string;
+    sourcePaths?: string[];
+    sessionIds?: string[];
+};
+export interface DocumentMutationResult {
+    success: true;
+    action: 'created' | 'updated' | 'archived';
+    document: DocumentView;
+    snapshot: DocumentSnapshot;
+    maintenance?: {
+        runId: string;
+        provider: string;
+        summary: string;
+        memoryBodyIds: string[];
+        archivedDocumentIds: string[];
+    };
+}
+export interface DocumentCapacityPlan {
+    projected: number;
+    limit: number;
+    fits: boolean;
+    candidates: DocumentRecord[];
+}
+export declare class DocumentCapacityError extends Error {
+    readonly projected: number;
+    readonly limit: number;
+    readonly candidates: DocumentRecord[];
+    constructor(projected: number, limit: number, candidates: DocumentRecord[]);
+}
+export declare class DocumentConflictError extends Error {
+    constructor();
+}
+/** Project-scoped control plane for managed active and cold document copies. */
+export declare class DocumentController {
+    readonly limitBytes: number;
+    private readonly now;
+    readonly workspaceRoot: string;
+    readonly storageRoot: string;
+    readonly directory: string;
+    readonly activeDirectory: string;
+    readonly archivedDirectory: string;
+    readonly indexPath: string;
+    readonly lockPath: string;
+    private readonly managedRelativePrefix;
+    private queue;
+    constructor(workspaceRoot: string, limitBytes?: number, now?: () => Date, storageRoot?: string);
+    snapshot(): DocumentSnapshot;
+    get(id: string): DocumentView;
+    capacityPlan(request: DocumentMutation): DocumentCapacityPlan;
+    search(query: string, options?: {
+        includeArchived?: boolean;
+        limit?: number;
+    }): Promise<DocumentSearchResult>;
+    mutate(request: DocumentMutation): Promise<DocumentMutationResult>;
+    archive(id: string, expectedRevision: number, details: {
+        summary: string;
+        memoryBodyIds: string[];
+    }): Promise<DocumentMutationResult>;
+    private mutateLocked;
+    private initialize;
+    private readIndex;
+    private snapshotUnlocked;
+    private requireDocument;
+    private assertCapacity;
+    private normalizeSourcePaths;
+    private relativeManagedPath;
+    private pathFor;
+    private readBody;
+    private view;
+    private persistDocument;
+    private persistIndex;
+    private atomicWrite;
+    private withLock;
+}
+/** Resolves one cached controller per canonical DSH workspace. */
+export declare class DocumentManager {
+    private readonly limitBytes;
+    private readonly now;
+    private readonly storageRoot?;
+    private readonly controllers;
+    constructor(limitBytes?: number, now?: () => Date, storageRoot?: (() => string) | undefined);
+    forWorkspace(workspaceRoot: string): DocumentController;
+    forAgent(agent: HostAgent): DocumentController;
+}
+//# sourceMappingURL=documents.d.ts.map

package/lib/types/documents.d.ts.map

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