maka-agent 0.2.0-dev.43.20260919 → 0.2.0-dev.45.20260921

package/node_modules/@maka/runtime-host/dist/protocol/deep-research.js

@@ -1,233 +0,0 @@
-/*
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements.  See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership.  The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License.  You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-import { DEEP_RESEARCH_CHECKLIST_ITEMS_MAX, DEEP_RESEARCH_CLIENT_IMPLEMENTATION_PROMPT_MAX_BYTES, DEEP_RESEARCH_CLIENT_OBJECTIVE_MAX_BYTES, DEEP_RESEARCH_CLIENT_RECENT_ITEMS_MAX, DEEP_RESEARCH_CLIENT_TEXT_MAX_BYTES, DEEP_RESEARCH_INSPECTED_REF_KINDS, DEEP_RESEARCH_REPORT_SECTION_KEYS, DEEP_RESEARCH_REPORT_SECTION_STATUSES, DEEP_RESEARCH_RUN_STATUSES, DEEP_RESEARCH_SCOPE_LEVELS, DEEP_RESEARCH_STAGES, DEEP_RESEARCH_CHECKLIST_STATUSES, } from '@maka/core/deep-research-run';
-import { requireCount, requireEncodedByteLimit, requireEntityId, requireExactRecord, requireShapedRecord, requireUtf8String, } from './codec.js';
-import { invalidProtocolFrame } from './errors.js';
-import { defineOperation } from './operation-spec.js';
-export const DEEP_RESEARCH_RESULT_MAX_BYTES = 48 * 1024;
-export const DEEP_RESEARCH_RECENT_REFS_MAX = DEEP_RESEARCH_CLIENT_RECENT_ITEMS_MAX;
-export { DEEP_RESEARCH_CLIENT_OBJECTIVE_MAX_BYTES, DEEP_RESEARCH_CLIENT_TEXT_MAX_BYTES };
-export const DEEP_RESEARCH_IMPLEMENTATION_PROMPT_MAX_BYTES = DEEP_RESEARCH_CLIENT_IMPLEMENTATION_PROMPT_MAX_BYTES;
-const DEEP_RESEARCH_STABLE_ID_MAX_BYTES = 128;
-const DEEP_RESEARCH_STABLE_ID = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/;
-const QUERY_ERRORS = [
-    'host_not_ready',
-    'host_draining',
-    'operation_unavailable',
-    'not_found',
-    'session_archived',
-    'invalid_request',
-    'internal_failure',
-];
-export function encodeDeepResearchSnapshot(progress, revision) {
-    return decodeDeepResearchQueryResult({
-        kind: 'snapshot',
-        revision,
-        ...progress,
-        checklist: progress.checklist.map((item) => ({
-            ...item,
-            blockedReason: item.blockedReason ?? null,
-        })),
-        recentInspectedRefs: progress.recentInspectedRefs.map((ref) => ({
-            ...ref,
-            label: ref.label ?? null,
-        })),
-        reportArtifactId: progress.reportArtifactId ?? null,
-        implementationPrompt: progress.implementationPrompt ?? null,
-    });
-}
-export const DEEP_RESEARCH_OPERATION_SPECS = {
-    'deep-research.query': defineOperation({
-        mode: 'query',
-        availability: 'ready',
-        errors: QUERY_ERRORS,
-        decodeInput: decodeDeepResearchQueryInput,
-        decodeOutput: decodeDeepResearchQueryResult,
-        assertOutputForInput(input, output) {
-            if (output.sessionId !== input.sessionId) {
-                throw invalidProtocolFrame('Deep Research result belongs to a different Session');
-            }
-        },
-    }),
-};
-export function decodeDeepResearchQueryInput(value) {
-    const input = requireExactRecord(value, 'Deep Research query input', ['sessionId']);
-    return { sessionId: requireEntityId(input.sessionId, 'sessionId') };
-}
-export function decodeDeepResearchQueryResult(value) {
-    requireEncodedByteLimit(value, 'Deep Research query result', DEEP_RESEARCH_RESULT_MAX_BYTES);
-    const record = requireShapedRecord(value, 'Deep Research query result', ['kind', 'sessionId', 'revision'], [
-        'objective',
-        'scopeLevel',
-        'status',
-        'stage',
-        'round',
-        'createdAt',
-        'updatedAt',
-        'artifactsCount',
-        'stepsCount',
-        'checklist',
-        'reportSections',
-        'recentInspectedRefs',
-        'workerRunIds',
-        'blockers',
-        'reportArtifactId',
-        'implementationPrompt',
-    ]);
-    const sessionId = requireEntityId(record.sessionId, 'sessionId');
-    const revision = requireCount(record.revision, 'Deep Research revision');
-    if (record.kind === 'not_started') {
-        requireExactRecord(record, 'Deep Research not-started result', [
-            'kind',
-            'sessionId',
-            'revision',
-        ]);
-        if (revision !== 0)
-            throw invalidProtocolFrame('Invalid Deep Research not-started revision');
-        return { kind: 'not_started', sessionId, revision: 0 };
-    }
-    if (record.kind !== 'snapshot') {
-        throw invalidProtocolFrame('Invalid Deep Research query result kind');
-    }
-    requireExactRecord(record, 'Deep Research snapshot result', [
-        'kind',
-        'sessionId',
-        'revision',
-        'objective',
-        'scopeLevel',
-        'status',
-        'stage',
-        'round',
-        'createdAt',
-        'updatedAt',
-        'artifactsCount',
-        'stepsCount',
-        'checklist',
-        'reportSections',
-        'recentInspectedRefs',
-        'workerRunIds',
-        'blockers',
-        'reportArtifactId',
-        'implementationPrompt',
-    ]);
-    if (revision === 0)
-        throw invalidProtocolFrame('Invalid Deep Research snapshot revision');
-    return {
-        kind: 'snapshot',
-        sessionId,
-        revision,
-        objective: requireUtf8String(record.objective, 'Deep Research objective', DEEP_RESEARCH_CLIENT_OBJECTIVE_MAX_BYTES),
-        scopeLevel: requireEnum(record.scopeLevel, DEEP_RESEARCH_SCOPE_LEVELS, 'Deep Research scope level'),
-        status: requireEnum(record.status, DEEP_RESEARCH_RUN_STATUSES, 'Deep Research status'),
-        stage: requireEnum(record.stage, DEEP_RESEARCH_STAGES, 'Deep Research stage'),
-        round: requireCount(record.round, 'Deep Research round'),
-        createdAt: requireCount(record.createdAt, 'Deep Research createdAt'),
-        updatedAt: requireCount(record.updatedAt, 'Deep Research updatedAt'),
-        artifactsCount: requireCount(record.artifactsCount, 'Deep Research artifact count'),
-        stepsCount: requireCount(record.stepsCount, 'Deep Research step count'),
-        checklist: decodeChecklist(record.checklist),
-        reportSections: decodeReportSections(record.reportSections),
-        recentInspectedRefs: decodeInspectedRefs(record.recentInspectedRefs),
-        workerRunIds: decodeIds(record.workerRunIds, 'Deep Research worker run ids'),
-        blockers: decodeTexts(record.blockers, 'Deep Research blockers'),
-        reportArtifactId: nullableId(record.reportArtifactId, 'Deep Research report artifact id'),
-        implementationPrompt: nullableText(record.implementationPrompt, 'Deep Research implementation prompt', DEEP_RESEARCH_IMPLEMENTATION_PROMPT_MAX_BYTES),
-    };
-}
-function decodeTexts(value, name) {
-    if (!Array.isArray(value) || value.length > DEEP_RESEARCH_RECENT_REFS_MAX) {
-        throw invalidProtocolFrame(`Invalid ${name}`);
-    }
-    return value.map((item) => requireUtf8String(item, name, DEEP_RESEARCH_CLIENT_TEXT_MAX_BYTES));
-}
-function decodeChecklist(value) {
-    if (!Array.isArray(value) || value.length > DEEP_RESEARCH_CHECKLIST_ITEMS_MAX) {
-        throw invalidProtocolFrame('Invalid Deep Research checklist');
-    }
-    return value.map((candidate) => {
-        const item = requireExactRecord(candidate, 'Deep Research checklist item', [
-            'itemId',
-            'title',
-            'status',
-            'blockedReason',
-        ]);
-        return {
-            itemId: requireEntityId(item.itemId, 'Deep Research checklist item id'),
-            title: requireUtf8String(item.title, 'Deep Research checklist title', DEEP_RESEARCH_CLIENT_TEXT_MAX_BYTES),
-            status: requireEnum(item.status, DEEP_RESEARCH_CHECKLIST_STATUSES, 'Deep Research checklist status'),
-            blockedReason: nullableText(item.blockedReason, 'Deep Research checklist blocker', DEEP_RESEARCH_CLIENT_TEXT_MAX_BYTES),
-        };
-    });
-}
-function decodeReportSections(value) {
-    if (!Array.isArray(value) || value.length > DEEP_RESEARCH_REPORT_SECTION_KEYS.length) {
-        throw invalidProtocolFrame('Invalid Deep Research report sections');
-    }
-    return value.map((candidate) => {
-        const section = requireExactRecord(candidate, 'Deep Research report section', [
-            'key',
-            'status',
-        ]);
-        return {
-            key: requireEnum(section.key, DEEP_RESEARCH_REPORT_SECTION_KEYS, 'Deep Research report section key'),
-            status: requireEnum(section.status, DEEP_RESEARCH_REPORT_SECTION_STATUSES, 'Deep Research report section status'),
-        };
-    });
-}
-function decodeInspectedRefs(value) {
-    if (!Array.isArray(value) || value.length > DEEP_RESEARCH_RECENT_REFS_MAX) {
-        throw invalidProtocolFrame('Invalid Deep Research inspected refs');
-    }
-    return value.map((candidate) => {
-        const ref = requireExactRecord(candidate, 'Deep Research inspected ref', [
-            'kind',
-            'locator',
-            'label',
-        ]);
-        return {
-            kind: requireEnum(ref.kind, DEEP_RESEARCH_INSPECTED_REF_KINDS, 'Deep Research inspected ref kind'),
-            locator: requireUtf8String(ref.locator, 'Deep Research inspected ref locator', DEEP_RESEARCH_CLIENT_TEXT_MAX_BYTES),
-            label: nullableText(ref.label, 'Deep Research inspected ref label', DEEP_RESEARCH_CLIENT_TEXT_MAX_BYTES),
-        };
-    });
-}
-function decodeIds(value, label) {
-    if (!Array.isArray(value) || value.length > DEEP_RESEARCH_RECENT_REFS_MAX) {
-        throw invalidProtocolFrame(`Invalid ${label}`);
-    }
-    return value.map((candidate) => requireStableResearchId(candidate, label));
-}
-function nullableId(value, label) {
-    return value === null ? null : requireEntityId(value, label);
-}
-function nullableText(value, label, maxBytes) {
-    return value === null ? null : requireUtf8String(value, label, maxBytes);
-}
-function requireStableResearchId(value, label) {
-    const id = requireUtf8String(value, label, DEEP_RESEARCH_STABLE_ID_MAX_BYTES);
-    if (!DEEP_RESEARCH_STABLE_ID.test(id))
-        throw invalidProtocolFrame(`Invalid ${label}`);
-    return id;
-}
-function requireEnum(value, values, label) {
-    if (typeof value !== 'string' || !values.includes(value)) {
-        throw invalidProtocolFrame(`Invalid ${label}`);
-    }
-    return value;
-}

package/node_modules/@maka/runtime-host/dist/server/deep-research-coordinator.js

@@ -1,116 +0,0 @@
-/*
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements.  See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership.  The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License.  You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-import { projectDeepResearchEvents } from '@maka/core/deep-research-run';
-import { projectDeepResearchClientProgress } from '@maka/core/deep-research-client-progress';
-import { isDeepResearchSession } from '@maka/core/deep-research';
-import { buildDeepResearchTools } from '@maka/runtime/deep-research-tools';
-import { authenticateInteractiveArtifactStoreWriter, } from '@maka/storage/artifact-stores';
-import { authenticateInteractiveDeepResearchStoreWriter, } from '@maka/storage/deep-research-authority';
-import { isSessionNotFoundError, } from '@maka/storage/execution-stores';
-import { encodeDeepResearchSnapshot, } from '../protocol/index.js';
-/** Host-owned Deep Research ledger, model-tool, and Client projection boundary. */
-export class HostDeepResearchCoordinator {
-    handlers = {
-        'deep-research.query': (input) => this.#sessionAdmission.run(input.sessionId, () => this.#query(input)),
-    };
-    #store;
-    #artifacts;
-    #sessions;
-    #sessionAdmission;
-    #unsubscribe;
-    constructor(input) {
-        this.#store = authenticateInteractiveDeepResearchStoreWriter(input.store);
-        this.#artifacts = authenticateInteractiveArtifactStoreWriter(input.artifacts);
-        this.#sessions = input.sessions;
-        this.#sessionAdmission = input.sessionAdmission;
-        this.#unsubscribe = this.#store.subscribe(({ sessionId }) => {
-            input.onProjectionChanged(sessionId);
-        });
-    }
-    toolsForSession(sessionId) {
-        return buildDeepResearchTools({
-            store: this.#store,
-            artifactStore: {
-                create: async (input) => {
-                    if (input.sessionId !== sessionId) {
-                        throw new Error('Deep Research tool attempted to write another Session');
-                    }
-                    return this.#artifacts.create(input);
-                },
-                get: async (artifactId) => (await this.#artifacts.getInSession(sessionId, artifactId)).record ?? null,
-                readText: (artifactId, options) => this.#artifacts.readTextInSession(sessionId, artifactId, options),
-                delete: (artifactId) => this.#artifacts.deleteOwnedArtifactInSession(sessionId, artifactId, 'deep_research'),
-            },
-        });
-    }
-    close() {
-        this.#unsubscribe();
-    }
-    async #query(input) {
-        const unavailable = await this.#assertSessionAvailable(input.sessionId);
-        if (unavailable)
-            return failure(unavailable.code, unavailable.message);
-        try {
-            const events = await this.#store.readEvents(input.sessionId);
-            if (events.length === 0) {
-                return success({ kind: 'not_started', sessionId: input.sessionId, revision: 0 });
-            }
-            const projection = projectDeepResearchEvents(events);
-            if (projection.diagnostics.length > 0 || !projection.run) {
-                return failure('internal_failure', 'Deep Research projection is unavailable');
-            }
-            return success(projectDeepResearchRun(projection.run, events.length));
-        }
-        catch (error) {
-            if (isSessionNotFoundError(error))
-                return failure('not_found', 'Session does not exist');
-            return failure('internal_failure', 'Deep Research projection is unavailable');
-        }
-    }
-    async #assertSessionAvailable(sessionId) {
-        try {
-            const header = await this.#sessions.readHeaderSnapshot(sessionId);
-            if (header.isArchived) {
-                return { code: 'session_archived', message: 'Session is archived' };
-            }
-            if (!isDeepResearchSession(header.labels)) {
-                return {
-                    code: 'invalid_request',
-                    message: 'Session is not a Deep Research Session',
-                };
-            }
-            return undefined;
-        }
-        catch (error) {
-            if (isSessionNotFoundError(error)) {
-                return { code: 'not_found', message: 'Session does not exist' };
-            }
-            return { code: 'internal_failure', message: 'Session authority is unavailable' };
-        }
-    }
-}
-export function projectDeepResearchRun(run, revision) {
-    return encodeDeepResearchSnapshot(projectDeepResearchClientProgress(run), revision);
-}
-function success(result) {
-    return { ok: true, result };
-}
-function failure(code, message) {
-    return { ok: false, error: { code, message } };
-}

package/node_modules/@maka/storage/dist/deep-research-authority.js

@@ -1,129 +0,0 @@
-/*
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements.  See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership.  The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License.  You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-import { assertStorageRootLease, runWithStorageRootLease, StorageRootAuthorityError, } from './root-authority.js';
-import { createSqliteDeepResearchStore, } from './deep-research-store.js';
-const writerBrand = Symbol('InteractiveDeepResearchStoreWriter');
-const writers = new WeakSet();
-const writerByLease = new WeakMap();
-const writerOpeningByLease = new WeakMap();
-export function authenticateInteractiveDeepResearchStoreWriter(writer) {
-    if (!writers.has(writer)) {
-        throw new StorageRootAuthorityError('invalid_lease', 'Expected an authentic interactive Deep Research Store writer');
-    }
-    return writer;
-}
-export async function openInteractiveDeepResearchStoreForWrite(lease) {
-    await assertStorageRootLease(lease, 'interactive', 'write');
-    const existing = writerByLease.get(lease);
-    if (existing)
-        return existing;
-    const opening = writerOpeningByLease.get(lease);
-    if (opening)
-        return opening;
-    const pending = Promise.resolve().then(async () => {
-        let store;
-        try {
-            store = await runWithStorageRootLease(lease, 'interactive', 'write', async (root) => {
-                const opened = createSqliteDeepResearchStore(root);
-                try {
-                    await opened.ready();
-                    return opened;
-                }
-                catch (error) {
-                    opened.close();
-                    throw error;
-                }
-            });
-            await assertStorageRootLease(lease, 'interactive', 'write');
-            const recoveredExisting = writerByLease.get(lease);
-            if (recoveredExisting) {
-                store.close();
-                return recoveredExisting;
-            }
-            const writer = createWriterFacade(lease, store);
-            writers.add(writer);
-            writerByLease.set(lease, writer);
-            return writer;
-        }
-        catch (error) {
-            store?.close();
-            throw error;
-        }
-    });
-    writerOpeningByLease.set(lease, pending);
-    try {
-        return await pending;
-    }
-    finally {
-        if (writerOpeningByLease.get(lease) === pending)
-            writerOpeningByLease.delete(lease);
-    }
-}
-function createWriterFacade(lease, store) {
-    let closed = false;
-    const run = (operation) => {
-        if (closed) {
-            return Promise.reject(new StorageRootAuthorityError('invalid_lease', 'Deep Research Store writer is closed'));
-        }
-        return runWithStorageRootLease(lease, 'interactive', 'write', operation);
-    };
-    const writer = {
-        kind: 'interactive',
-        access: 'write',
-        [writerBrand]: true,
-        read: (sessionId) => run(() => store.read(sessionId)),
-        readEvents: (sessionId) => run(() => store.readEvents(sessionId)),
-        start: (sessionId, objective, scopeLevel, context) => run(() => store.start(sessionId, objective, scopeLevel, cloneContext(context))),
-        recordArtifact: (sessionId, artifact, context) => run(() => store.recordArtifact(sessionId, cloneArtifact(artifact), cloneContext(context))),
-        updateChecklist: (sessionId, item, context) => run(() => store.updateChecklist(sessionId, cloneChecklist(item), cloneContext(context))),
-        recordStep: (sessionId, step, context) => run(() => store.recordStep(sessionId, cloneStep(step), cloneContext(context))),
-        recordCheckpoint: (sessionId, checkpoint, context) => run(() => store.recordCheckpoint(sessionId, cloneCheckpoint(checkpoint), cloneContext(context))),
-        complete: (sessionId, reportArtifactId, handoff, context) => run(() => store.complete(sessionId, reportArtifactId, cloneHandoff(handoff), cloneContext(context))),
-        subscribe: (listener) => store.subscribe(listener),
-        purgeSessionState: (sessionId) => run(() => store.purgeSessionState(sessionId)),
-        close: () => {
-            if (closed)
-                return;
-            closed = true;
-            if (writerByLease.get(lease) === writer)
-                writerByLease.delete(lease);
-            writers.delete(writer);
-            store.close();
-        },
-    };
-    return Object.freeze(writer);
-}
-function cloneContext(context) {
-    return context ? { ...context } : undefined;
-}
-function cloneArtifact(artifact) {
-    return structuredClone(artifact);
-}
-function cloneChecklist(item) {
-    return structuredClone(item);
-}
-function cloneStep(step) {
-    return structuredClone(step);
-}
-function cloneCheckpoint(checkpoint) {
-    return structuredClone(checkpoint);
-}
-function cloneHandoff(handoff) {
-    return structuredClone(handoff);
-}