@awiki/dsh-plugin 0.2.0-rc.4

package/lib/types/session.d.ts

@@ -0,0 +1,14 @@
+/** Persist only the local session lock; identity and SecretVault data remain SDK-owned. */
+export declare class AwikiSessionStore {
+    private readonly hostDirectory;
+    private readonly markerPath;
+    constructor(stateRoot: string);
+    /** Return whether this installation was explicitly signed out. */
+    isSignedOut(): Promise<boolean>;
+    /** Lock this installation without modifying the persisted identity. */
+    signOut(): Promise<void>;
+    /** Unlock this installation while retaining every SDK-owned file. */
+    signIn(): Promise<void>;
+    private hasPrivateHostDirectory;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAKA,2FAA2F;AAC3F,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEhB,SAAS,EAAE,MAAM;IAKpC,kEAAkE;IACrD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAe5C,uEAAuE;IAC1D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAYrC,qEAAqE;IACxD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAQtB,uBAAuB;CAYtC"}

package/lib/types/session.js

@@ -0,0 +1,76 @@
+import { chmod, lstat, mkdir, readFile, unlink, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const SIGNED_OUT_MARKER = 'signed-out-v1\n';
+/** Persist only the local session lock; identity and SecretVault data remain SDK-owned. */
+export class AwikiSessionStore {
+    hostDirectory;
+    markerPath;
+    constructor(stateRoot) {
+        this.hostDirectory = join(stateRoot, '.host');
+        this.markerPath = join(this.hostDirectory, 'signed-out');
+    }
+    /** Return whether this installation was explicitly signed out. */
+    async isSignedOut() {
+        if (!(await this.hasPrivateHostDirectory()))
+            return false;
+        try {
+            const metadata = await lstat(this.markerPath);
+            if (!metadata.isFile() || metadata.isSymbolicLink())
+                throw new TypeError('awiki: local session marker is invalid');
+            if ((await readFile(this.markerPath, 'utf8')) !== SIGNED_OUT_MARKER) {
+                throw new TypeError('awiki: local session marker is invalid');
+            }
+            return true;
+        }
+        catch (error) {
+            if (isMissing(error))
+                return false;
+            throw error;
+        }
+    }
+    /** Lock this installation without modifying the persisted identity. */
+    async signOut() {
+        await mkdir(this.hostDirectory, { recursive: true, mode: 0o700 });
+        await this.hasPrivateHostDirectory();
+        await chmod(this.hostDirectory, 0o700);
+        try {
+            await writeFile(this.markerPath, SIGNED_OUT_MARKER, { flag: 'wx', mode: 0o600 });
+        }
+        catch (error) {
+            if (!isFileExists(error) || !(await this.isSignedOut()))
+                throw error;
+        }
+        await chmod(this.markerPath, 0o600);
+    }
+    /** Unlock this installation while retaining every SDK-owned file. */
+    async signIn() {
+        try {
+            await unlink(this.markerPath);
+        }
+        catch (error) {
+            if (!isMissing(error))
+                throw error;
+        }
+    }
+    async hasPrivateHostDirectory() {
+        try {
+            const directory = await lstat(this.hostDirectory);
+            if (!directory.isDirectory() || directory.isSymbolicLink()) {
+                throw new TypeError('awiki: local session directory is invalid');
+            }
+            return true;
+        }
+        catch (error) {
+            if (isMissing(error))
+                return false;
+            throw error;
+        }
+    }
+}
+function isMissing(error) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT';
+}
+function isFileExists(error) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === 'EEXIST';
+}
+//# sourceMappingURL=session.js.map

package/lib/types/session.js.map

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

package/lib/types/settings-rpc-contract.d.ts

@@ -0,0 +1,34 @@
+/** Client-safe contract for AWiki's plugin-owned settings transport. */
+/** Dedicated Connection channel; the Host registers it with loopback authority. */
+export declare const AWIKI_SETTINGS_RPC_CHANNEL = "/awiki-settings";
+/** Supported channel-relative operations. */
+export declare const AWIKI_SETTINGS_RPC_ENDPOINTS: {
+    readonly describe: "describe";
+    readonly setDomain: "set-domain";
+    readonly resetDomain: "reset-domain";
+};
+/** Minimal, secret-free settings view returned to the browser. */
+export interface AwikiSettingsRpcView {
+    readonly value: {
+        readonly domain: string;
+    };
+    readonly base?: {
+        readonly domain?: string;
+    };
+    readonly user?: {
+        readonly domain?: string;
+    };
+    readonly revision: number;
+    readonly writable: boolean;
+}
+/** Optimistic revision carried by every browser write. */
+export interface AwikiSettingsRevisionRequest {
+    readonly expectedRevision: number;
+}
+/** Domain write request. */
+export interface AwikiSettingsSetDomainRequest extends AwikiSettingsRevisionRequest {
+    readonly domain: string;
+}
+/** Fail closed when the Host response is not exactly usable by the settings UI. */
+export declare function decodeAwikiSettingsRpcView(value: unknown): AwikiSettingsRpcView | undefined;
+//# sourceMappingURL=settings-rpc-contract.d.ts.map

package/lib/types/settings-rpc-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-rpc-contract.d.ts","sourceRoot":"","sources":["../../src/settings-rpc-contract.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAIxE,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,oBAAoB,CAAA;AAE3D,6CAA6C;AAC7C,eAAO,MAAM,4BAA4B;;;;CAI/B,CAAA;AAEV,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B;AAED,0DAA0D;AAC1D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAClC;AAED,4BAA4B;AAC5B,MAAM,WAAW,6BAA8B,SAAQ,4BAA4B;IACjF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAmBD,mFAAmF;AACnF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAyB3F"}

package/lib/types/settings-rpc-contract.js

@@ -0,0 +1,62 @@
+/** Client-safe contract for AWiki's plugin-owned settings transport. */
+import { normalizeAwikiDomain } from "./domain.js";
+/** Dedicated Connection channel; the Host registers it with loopback authority. */
+export const AWIKI_SETTINGS_RPC_CHANNEL = '/awiki-settings';
+/** Supported channel-relative operations. */
+export const AWIKI_SETTINGS_RPC_ENDPOINTS = {
+    describe: 'describe',
+    setDomain: 'set-domain',
+    resetDomain: 'reset-domain',
+};
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function decodeLayer(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (!Object.hasOwn(value, 'domain'))
+        return {};
+    if (typeof value.domain !== 'string')
+        return undefined;
+    try {
+        const domain = normalizeAwikiDomain(value.domain);
+        if (domain !== value.domain)
+            return undefined;
+        return { domain };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Fail closed when the Host response is not exactly usable by the settings UI. */
+export function decodeAwikiSettingsRpcView(value) {
+    if (!isRecord(value)
+        || !isRecord(value.value)
+        || typeof value.value.domain !== 'string'
+        || !Number.isSafeInteger(value.revision)
+        || value.revision < 0
+        || typeof value.writable !== 'boolean')
+        return undefined;
+    let domain;
+    try {
+        domain = normalizeAwikiDomain(value.value.domain);
+    }
+    catch {
+        return undefined;
+    }
+    if (domain !== value.value.domain)
+        return undefined;
+    const base = value.base === undefined ? undefined : decodeLayer(value.base);
+    const user = value.user === undefined ? undefined : decodeLayer(value.user);
+    if ((value.base !== undefined && base === undefined)
+        || (value.user !== undefined && user === undefined))
+        return undefined;
+    return {
+        value: { domain },
+        ...base === undefined ? {} : { base },
+        ...user === undefined ? {} : { user },
+        revision: value.revision,
+        writable: value.writable,
+    };
+}
+//# sourceMappingURL=settings-rpc-contract.js.map

package/lib/types/settings-rpc-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-rpc-contract.js","sourceRoot":"","sources":["../../src/settings-rpc-contract.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,mFAAmF;AACnF,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAA;AAE3D,6CAA6C;AAC7C,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,YAAY;IACvB,WAAW,EAAE,cAAc;CACnB,CAAA;AAqBV,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACtC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAA;IAC9C,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IACtD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACjD,IAAI,MAAM,KAAK,KAAK,CAAC,MAAM;YAAE,OAAO,SAAS,CAAA;QAC7C,OAAO,EAAE,MAAM,EAAE,CAAA;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;WACf,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;WACtB,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ;WACtC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;WACpC,KAAK,CAAC,QAAmB,GAAG,CAAC;WAC9B,OAAO,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC1D,IAAI,MAAc,CAAA;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IACnD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3E,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,CAAC;WAC/C,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,CAAC;QAAE,OAAO,SAAS,CAAA;IACvE,OAAO;QACL,KAAK,EAAE,EAAE,MAAM,EAAE;QACjB,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;QACrC,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;QACrC,QAAQ,EAAE,KAAK,CAAC,QAAkB;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAA;AACH,CAAC"}

package/lib/types/settings-rpc.d.ts

@@ -0,0 +1,6 @@
+/** Loopback-only Host transport for AWiki's durable plugin settings. */
+import { type SettingsProvider } from '@deepseek-ai/dsh-settings';
+import type { ConnectionRpcHandler } from '@deepseek-ai/dsh-client-connection';
+/** Build a handler whose provider lookup remains correct across Cordis reinjection. */
+export declare function createAwikiSettingsRpcHandler(getProvider: () => SettingsProvider | undefined): ConnectionRpcHandler;
+//# sourceMappingURL=settings-rpc.d.ts.map

package/lib/types/settings-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-rpc.d.ts","sourceRoot":"","sources":["../../src/settings-rpc.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAA;AAiF9E,uFAAuF;AACvF,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,gBAAgB,GAAG,SAAS,GAC9C,oBAAoB,CA4DtB"}

package/lib/types/settings-rpc.js

@@ -0,0 +1,147 @@
+/** Loopback-only Host transport for AWiki's durable plugin settings. */
+import { SettingsConflictError, settingsNamespace, } from '@deepseek-ai/dsh-settings';
+import { AWIKI_DOMAIN_FIELD, AWIKI_SETTINGS_NAMESPACE, normalizeAwikiDomain } from "./domain.js";
+import { AWIKI_SETTINGS_RPC_ENDPOINTS, } from "./settings-rpc-contract.js";
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function expectedRevision(payload) {
+    if (!isRecord(payload) || !Number.isSafeInteger(payload.expectedRevision) || payload.expectedRevision < 0) {
+        return undefined;
+    }
+    return payload.expectedRevision;
+}
+function sanitizeLayer(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (!Object.hasOwn(value, AWIKI_DOMAIN_FIELD))
+        return {};
+    if (typeof value[AWIKI_DOMAIN_FIELD] !== 'string')
+        return undefined;
+    const domain = normalizeAwikiDomain(value[AWIKI_DOMAIN_FIELD]);
+    if (domain !== value[AWIKI_DOMAIN_FIELD])
+        return undefined;
+    return { domain };
+}
+function view(provider) {
+    const descriptor = provider.describe({ redactSecrets: true })
+        .find(candidate => candidate.ns === AWIKI_SETTINGS_NAMESPACE);
+    if (descriptor === undefined || !isRecord(descriptor.value) || typeof descriptor.value.domain !== 'string') {
+        return undefined;
+    }
+    const domain = normalizeAwikiDomain(descriptor.value.domain);
+    if (domain !== descriptor.value.domain)
+        return undefined;
+    const base = descriptor.base === undefined ? undefined : sanitizeLayer(descriptor.base);
+    const user = descriptor.user === undefined ? undefined : sanitizeLayer(descriptor.user);
+    if ((descriptor.base !== undefined && base === undefined)
+        || (descriptor.user !== undefined && user === undefined))
+        return undefined;
+    return {
+        value: { domain },
+        ...base === undefined ? {} : { base },
+        ...user === undefined ? {} : { user },
+        revision: descriptor.revision,
+        writable: provider.writable,
+    };
+}
+function unavailable() {
+    return {
+        ok: false,
+        error: {
+            code: 'settings-not-exposed',
+            message: 'AWiki settings are unavailable in this Host composition.',
+            details: { ns: AWIKI_SETTINGS_NAMESPACE },
+        },
+    };
+}
+function badRequest() {
+    return {
+        ok: false,
+        error: {
+            code: 'bad-request',
+            message: 'The AWiki settings request is invalid.',
+            details: { issues: [] },
+        },
+    };
+}
+function cancelled() {
+    return {
+        ok: false,
+        error: {
+            code: 'cancelled',
+            message: 'The AWiki settings request was cancelled.',
+            details: {},
+        },
+    };
+}
+/** Build a handler whose provider lookup remains correct across Cordis reinjection. */
+export function createAwikiSettingsRpcHandler(getProvider) {
+    return async (endpoint, payload, signal) => {
+        if (signal.aborted)
+            return cancelled();
+        const provider = getProvider();
+        if (provider === undefined)
+            return unavailable();
+        if (endpoint === AWIKI_SETTINGS_RPC_ENDPOINTS.describe) {
+            if (!isRecord(payload))
+                return badRequest();
+            const current = view(provider);
+            return current === undefined ? unavailable() : { ok: true, value: current };
+        }
+        const revision = expectedRevision(payload);
+        if (revision === undefined)
+            return badRequest();
+        let operation;
+        if (endpoint === AWIKI_SETTINGS_RPC_ENDPOINTS.setDomain) {
+            if (!isRecord(payload) || typeof payload.domain !== 'string')
+                return badRequest();
+            let domain;
+            try {
+                domain = normalizeAwikiDomain(payload.domain);
+            }
+            catch {
+                return badRequest();
+            }
+            if (domain !== payload.domain)
+                return badRequest();
+            operation = { op: 'set', path: [AWIKI_DOMAIN_FIELD], value: domain };
+        }
+        else if (endpoint === AWIKI_SETTINGS_RPC_ENDPOINTS.resetDomain) {
+            operation = { op: 'unset', path: [AWIKI_DOMAIN_FIELD] };
+        }
+        else {
+            return badRequest();
+        }
+        try {
+            await provider.mutate(settingsNamespace(AWIKI_SETTINGS_NAMESPACE), [operation], revision);
+            const current = view(provider);
+            return current === undefined ? unavailable() : { ok: true, value: current };
+        }
+        catch (cause) {
+            if (cause instanceof SettingsConflictError) {
+                return {
+                    ok: false,
+                    error: {
+                        code: 'settings-conflict',
+                        message: 'AWiki settings changed in another client.',
+                        details: {
+                            ns: AWIKI_SETTINGS_NAMESPACE,
+                            expected: cause.expected,
+                            actual: cause.actual,
+                        },
+                    },
+                };
+            }
+            return {
+                ok: false,
+                error: {
+                    code: 'settings-rejected',
+                    message: 'The Host rejected the AWiki settings change.',
+                    details: { ns: AWIKI_SETTINGS_NAMESPACE },
+                },
+            };
+        }
+    };
+}
+//# sourceMappingURL=settings-rpc.js.map

package/lib/types/settings-rpc.js.map

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

package/lib/types/settings.d.ts

@@ -0,0 +1,13 @@
+/** Durable AWiki settings shared by the Host service and browser settings page. */
+import z from '@deepseek-ai/schemastery';
+export { AWIKI_DOMAIN_FIELD, AWIKI_SETTINGS_NAMESPACE, DEFAULT_AWIKI_DOMAIN, normalizeAwikiDomain } from './domain.ts';
+/** Persisted AWiki settings. */
+export interface AwikiSettings {
+    /** Handle provider domain used by registration and bare-Handle resolution. */
+    readonly domain: string;
+}
+/** Durable AWiki schema exposed through the DSH settings service. */
+export declare const AwikiSettingsSchema: z<AwikiSettings>;
+/** Reject settings values that cannot be consumed as canonical domains. */
+export declare function validateAwikiSettings(value: AwikiSettings): void;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/settings.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAGxC,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEtH,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,aAAa,CAE/C,CAAA;AAEF,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAIhE"}

package/lib/types/settings.js

@@ -0,0 +1,15 @@
+/** Durable AWiki settings shared by the Host service and browser settings page. */
+import z from '@deepseek-ai/schemastery';
+import { AWIKI_DOMAIN_FIELD, DEFAULT_AWIKI_DOMAIN, normalizeAwikiDomain } from "./domain.js";
+export { AWIKI_DOMAIN_FIELD, AWIKI_SETTINGS_NAMESPACE, DEFAULT_AWIKI_DOMAIN, normalizeAwikiDomain } from "./domain.js";
+/** Durable AWiki schema exposed through the DSH settings service. */
+export const AwikiSettingsSchema = z.object({
+    [AWIKI_DOMAIN_FIELD]: z.string().default(DEFAULT_AWIKI_DOMAIN),
+});
+/** Reject settings values that cannot be consumed as canonical domains. */
+export function validateAwikiSettings(value) {
+    if (normalizeAwikiDomain(value.domain) !== value.domain) {
+        throw new TypeError('awiki: domain must be lowercase and must not contain surrounding whitespace');
+    }
+}
+//# sourceMappingURL=settings.js.map

package/lib/types/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/settings.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAE5F,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAQtH,qEAAqE;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAqB,CAAC,CAAC,MAAM,CAAC;IAC5D,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC;CAC/D,CAAC,CAAA;AAEF,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CAAC,KAAoB;IACxD,IAAI,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QACxD,MAAM,IAAI,SAAS,CAAC,6EAA6E,CAAC,CAAA;IACpG,CAAC;AACH,CAAC"}

package/lib/types/summary-provider-api.d.ts

@@ -0,0 +1,45 @@
+/** Same-process contract between the AWiki Host service and a replaceable summary provider. */
+import type { AwikiMessageId, AwikiSummaryTodo } from './types.ts';
+/** Data-minimized text message passed to the model provider. */
+export interface AwikiSummaryTextMessage {
+    readonly id: AwikiMessageId;
+    readonly sender: string;
+    readonly outgoing: boolean;
+    readonly sentAt: string;
+    readonly content: {
+        readonly kind: 'text';
+        readonly text: string;
+    };
+}
+/** Data-minimized attachment message. Attachment bytes and storage fields never enter this contract. */
+export interface AwikiSummaryAttachmentMessage {
+    readonly id: AwikiMessageId;
+    readonly sender: string;
+    readonly outgoing: boolean;
+    readonly sentAt: string;
+    readonly content: {
+        readonly kind: 'attachment';
+        readonly fileName: string;
+        readonly mimeType: string;
+        readonly size: number;
+        readonly caption?: string;
+    };
+}
+/** Chronological, JSON-safe message supplied to a summary provider. */
+export type AwikiSummarySourceMessage = AwikiSummaryTextMessage | AwikiSummaryAttachmentMessage;
+/** One bounded model request after Host-owned history selection and minimization. */
+export interface AwikiSummaryProviderRequest {
+    readonly messages: readonly AwikiSummarySourceMessage[];
+    readonly signal?: AbortSignal;
+}
+/** Strict structured output accepted from a summary provider. */
+export interface AwikiSummaryProviderResult {
+    readonly highlights: readonly string[];
+    readonly conclusions: readonly string[];
+    readonly todos: readonly AwikiSummaryTodo[];
+}
+/** Replaceable same-process provider used by the Host Remote. */
+export interface AwikiSummaryProvider {
+    summarize(request: AwikiSummaryProviderRequest): Promise<AwikiSummaryProviderResult>;
+}
+//# sourceMappingURL=summary-provider-api.d.ts.map

package/lib/types/summary-provider-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-provider-api.d.ts","sourceRoot":"","sources":["../../src/summary-provider-api.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElE,gEAAgE;AAChE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KACtB,CAAA;CACF;AAED,wGAAwG;AACxG,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;QAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAC1B,CAAA;CACF;AAED,uEAAuE;AACvE,MAAM,MAAM,yBAAyB,GAAG,uBAAuB,GAAG,6BAA6B,CAAA;AAE/F,qFAAqF;AACrF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,yBAAyB,EAAE,CAAA;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,iEAAiE;AACjE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAC5C;AAED,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAA;CACrF"}

package/lib/types/summary-provider-api.js

@@ -0,0 +1,3 @@
+/** Same-process contract between the AWiki Host service and a replaceable summary provider. */
+export {};
+//# sourceMappingURL=summary-provider-api.js.map

package/lib/types/summary-provider-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-provider-api.js","sourceRoot":"","sources":["../../src/summary-provider-api.ts"],"names":[],"mappings":"AAAA,+FAA+F"}

package/lib/types/summary-provider.d.ts

@@ -0,0 +1,48 @@
+/** One-shot LLM provider for user-triggered AWiki conversation summaries. */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { GenerateOptions, StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { AwikiSummaryProviderRequest, AwikiSummaryProviderResult } from './summary-provider-api.ts';
+/** Default end-to-end deadline for an auxiliary summary request. */
+export declare const DEFAULT_SUMMARY_TIMEOUT_MS = 30000;
+/** Default output cap for the small structured JSON response. */
+export declare const DEFAULT_SUMMARY_MAX_OUTPUT_TOKENS = 768;
+/** Loader configuration for the replaceable default summary provider. */
+export interface Config {
+    readonly timeoutMs?: number;
+    readonly maxOutputTokens?: number;
+}
+/** Loader schema for one-shot summary policy. */
+export declare const Config: z<Config>;
+/** Stable internal failure taxonomy consumed only by the Host normalizer. */
+export type AwikiSummaryProviderFailureCode = 'route-unavailable' | 'timeout' | 'cancelled' | 'model-failed' | 'truncated' | 'tool-call' | 'empty-output' | 'invalid-output';
+/** Closed provider error. Its message contains no model output or provider response. */
+export declare class AwikiSummaryProviderError extends Error {
+    readonly code: AwikiSummaryProviderFailureCode;
+    readonly name = "AwikiSummaryProviderError";
+    constructor(code: AwikiSummaryProviderFailureCode);
+}
+interface SummaryLlmContext {
+    readonly llm: {
+        stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
+    };
+    readonly agentDefaultModel: {
+        currentSelection(): {
+            readonly provider: string;
+            readonly model: string;
+            readonly reasoningEffort?: GenerateOptions['reasoningEffort'];
+        };
+    };
+}
+/** JSON-frame untrusted messages without allowing their content to escape the data boundary. */
+export declare function frameAwikiSummaryMessages(messages: AwikiSummaryProviderRequest['messages']): string;
+/** Execute one direct LLM stream without creating an Agent or writing a Session. */
+export declare function summarizeAwikiMessagesWithLlm(ctx: SummaryLlmContext, config: Config, request: AwikiSummaryProviderRequest): Promise<AwikiSummaryProviderResult>;
+/** Cordis plugin name used by Loader diagnostics. */
+export declare const name = "awiki-default-summary-provider";
+/** The Host registry and current Harness model route must exist before this provider loads. */
+export declare const inject: string[];
+/** Register the one-shot provider after the AWiki SDK provider. */
+export declare function apply(ctx: Context, config: Config): void;
+export {};
+//# sourceMappingURL=summary-provider.d.ts.map

package/lib/types/summary-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-provider.d.ts","sourceRoot":"","sources":["../../src/summary-provider.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,OAAO,KAAK,EAAgB,eAAe,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEtF,OAAO,KAAK,EAEV,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,2BAA2B,CAAA;AAGlC,oEAAoE;AACpE,eAAO,MAAM,0BAA0B,QAAS,CAAA;AAChD,iEAAiE;AACjE,eAAO,MAAM,iCAAiC,MAAM,CAAA;AAEpD,yEAAyE;AACzE,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,iDAAiD;AACjD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAG3B,CAAA;AAOF,6EAA6E;AAC7E,MAAM,MAAM,+BAA+B,GACvC,mBAAmB,GACnB,SAAS,GACT,WAAW,GACX,cAAc,GACd,WAAW,GACX,WAAW,GACX,cAAc,GACd,gBAAgB,CAAA;AAEpB,wFAAwF;AACxF,qBAAa,yBAA0B,SAAQ,KAAK;IAGtC,QAAQ,CAAC,IAAI,EAAE,+BAA+B;IAF1D,SAAkB,IAAI,+BAA8B;gBAE/B,IAAI,EAAE,+BAA+B;CAG3D;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,GAAG,EAAE;QACZ,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC,CAAA;KAC7D,CAAA;IACD,QAAQ,CAAC,iBAAiB,EAAE;QAC1B,gBAAgB,IAAI;YAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;YACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;YACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAA;SAC9D,CAAA;KACF,CAAA;CACF;AAgCD,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,GAAG,MAAM,CAEnG;AA6CD,oFAAoF;AACpF,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CA6DrC;AAyBD,qDAAqD;AACrD,eAAO,MAAM,IAAI,mCAAmC,CAAA;AACpD,+FAA+F;AAC/F,eAAO,MAAM,MAAM,UAAwC,CAAA;AAE3D,mEAAmE;AACnE,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAUxD"}