@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/query/activity.js

@@ -1,402 +1,2 @@
-/**
- * @module sdk/query/activity
- *
- * Implements the pm activity command surface and its agent-facing runtime behavior.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7005305a-5fd4-56b8-a0a0-5612e8bf48cc")}catch(e){}}();
-import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { isFileMissingError } from "../../core/fs/fs-utils.js";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { getActiveExtensionRegistrations, runActiveOnReadHooks, enforceHistoryStreamPolicyForItems, resolveItemTypeRegistry, EXIT_CODE, PmCliError, compareTimestampStrings, nowIso, resolveIsoOrRelative, listAllItemMetadataLight, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
-import { readHistoryEntries } from "../history-read.js";
-import { parseLimit } from "./parsers.js";
-import { resolveModePairedOutputOmissionReceipt, } from "../output-projection.js";
-import { compileHistoryProvenanceMatcher, projectHistoryProvenance, resolveHistoryProvenanceDimensions, summarizeHistoryProvenance, } from "../history-provenance.js";
-const DEFAULT_COMPACT_ACTIVITY_LIMIT = 20;
-const DEFAULT_FULL_ACTIVITY_LIMIT = 5;
-const DEFAULT_DIGEST_ACTIVITY_LIMIT = 15;
-const DEFAULT_DIGEST_WINDOW = "-24h";
-/** Normalize raw and full aliases into one explicit activity row projection. */
-export function normalizeActivityProjectionOptions(options) {
-    const normalized = { ...options };
-    if (normalized.full === true) {
-        normalized.raw = true;
-        normalized.compact = false;
-    }
-    else if (normalized.raw === true && normalized.compact === undefined) {
-        normalized.compact = true;
-    }
-    delete normalized.full;
-    return normalized;
-}
-const ACTIVITY_ROW_KEY_BY_MODE = {
-    digest: "activity_digest",
-    compact: "compact_activity",
-    provenance: "provenance_activity",
-    full: "activity",
-};
-function parseNonEmptyFilter(raw, flagLabel) {
-    if (raw === undefined)
-        return undefined;
-    const normalized = raw.trim();
-    if (normalized.length === 0) {
-        throw new PmCliError(`${flagLabel} must not be empty`, EXIT_CODE.USAGE);
-    }
-    return normalized;
-}
-function parseRangeBound(raw, nowValue, fieldLabel) {
-    if (raw === undefined)
-        return undefined;
-    const normalized = raw.trim();
-    if (normalized.length === 0) {
-        throw new PmCliError("Activity time bounds must not be empty", EXIT_CODE.USAGE);
-    }
-    const relativeInput = fieldLabel === "--from" && /^\d+[hdwm]$/iu.test(normalized)
-        ? `-${normalized}`
-        : normalized;
-    return resolveIsoOrRelative(relativeInput, new Date(nowValue), fieldLabel);
-}
-function includeByTimeWindow(entry, from, to) {
-    if (entry.ts.length === 0 && (from || to)) {
-        return false;
-    }
-    if (from && compareTimestampStrings(entry.ts, from) < 0) {
-        return false;
-    }
-    if (to && compareTimestampStrings(entry.ts, to) >= 0) {
-        return false;
-    }
-    return true;
-}
-function limitEntries(values, limit) {
-    if (limit === undefined)
-        return values;
-    return values.slice(0, limit);
-}
-function readActivityString(value, fallback = "") {
-    return typeof value === "string" ? value : fallback;
-}
-function normalizeActivityEntry(id, entry) {
-    return {
-        ...entry,
-        id,
-        ts: readActivityString(entry.ts),
-        author: readActivityString(entry.author, "unknown"),
-        op: readActivityString(entry.op, "unknown"),
-        patch: Array.isArray(entry.patch) ? entry.patch : [],
-        before_hash: readActivityString(entry.before_hash),
-        after_hash: readActivityString(entry.after_hash),
-    };
-}
-function sortActivity(entries) {
-    return [...entries].sort((a, b) => {
-        const byTimestamp = b.ts.localeCompare(a.ts);
-        if (byTimestamp !== 0)
-            return byTimestamp;
-        const byId = a.id.localeCompare(b.id);
-        if (byId !== 0)
-            return byId;
-        return a.op.localeCompare(b.op);
-    });
-}
-async function listHistoryFiles(historyDir) {
-    try {
-        return (await fs.readdir(historyDir))
-            .filter((entry) => entry.endsWith(".jsonl"))
-            .sort((a, b) => a.localeCompare(b));
-    }
-    catch (error) {
-        // Activity should degrade gracefully when optional history storage is absent.
-        if (isFileMissingError(error)) {
-            return [];
-        }
-        throw error;
-    }
-}
-function resolveActivityProjectionMode(options) {
-    if (options.raw !== true &&
-        options.compact !== true &&
-        options.provenance !== true) {
-        return "digest";
-    }
-    if (options.provenance === true)
-        return "provenance";
-    if (options.compact === true ||
-        (options.raw === true && options.compact !== false)) {
-        return "compact";
-    }
-    return "full";
-}
-function resolveActivityLimit(options, explicitLimit, projectionMode) {
-    if (options.unbounded === true)
-        return undefined;
-    if (explicitLimit !== undefined)
-        return explicitLimit;
-    if (projectionMode === "digest")
-        return DEFAULT_DIGEST_ACTIVITY_LIMIT;
-    if (projectionMode === "compact")
-        return DEFAULT_COMPACT_ACTIVITY_LIMIT;
-    return DEFAULT_FULL_ACTIVITY_LIMIT;
-}
-function resolveActivityFilters(options, projectionMode) {
-    const nowValue = nowIso();
-    const digest = projectionMode === "digest";
-    const to = parseRangeBound(options.to ?? (digest ? nowValue : undefined), nowValue, "--to");
-    const from = parseRangeBound(options.from ?? (digest ? DEFAULT_DIGEST_WINDOW : undefined), options.from === undefined && digest ? to : nowValue, "--from");
-    if (from && to && compareTimestampStrings(from, to) >= 0) {
-        throw new PmCliError("Activity --from must be before --to", EXIT_CODE.USAGE);
-    }
-    const explicitLimit = parseLimit(options.limit);
-    if (options.unbounded === true && explicitLimit !== undefined) {
-        throw new PmCliError("Activity --unbounded cannot be combined with --limit", EXIT_CODE.USAGE);
-    }
-    return {
-        id: parseNonEmptyFilter(options.id, "Activity --id"),
-        op: parseNonEmptyFilter(options.op, "Activity --op"),
-        author: parseNonEmptyFilter(options.author, "Activity --author"),
-        from,
-        to,
-        limit: resolveActivityLimit(options, explicitLimit, projectionMode),
-        limitSource: options.unbounded === true || explicitLimit !== undefined
-            ? "explicit"
-            : "default",
-        harness: options.harness,
-        agentInstance: options.agentInstance,
-        provenance: options.provenanceFilter,
-    };
-}
-async function resolveActivityRuntimeContext(global) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    await assertInitializedTracker(pmRoot);
-    return {
-        pmRoot,
-        settings: await readSettings(pmRoot),
-    };
-}
-async function prepareActivityHistoryRead(context) {
-    const typeRegistry = resolveItemTypeRegistry(context.settings, getActiveExtensionRegistrations());
-    const items = await listAllItemMetadataLight(context.pmRoot, context.settings.item_format, typeRegistry.type_to_folder, undefined, context.settings.schema);
-    await enforceHistoryStreamPolicyForItems({
-        pmRoot: context.pmRoot,
-        settings: context.settings,
-        itemIds: items.map((item) => item.id),
-        commandLabel: "activity",
-    });
-    const historyDir = path.join(context.pmRoot, "history");
-    await runActiveOnReadHooks({
-        path: historyDir,
-        scope: "project",
-    });
-    return {
-        historyDir,
-        itemsById: new Map(items.map((item) => [
-            item.id,
-            { title: item.title, type: item.type, status: item.status },
-        ])),
-    };
-}
-function includeActivityEntry(entry, candidate, filters) {
-    // Preserve legacy filter semantics: op/author filters compare the raw
-    // history row before missing metadata is normalized to "unknown" for display.
-    if (filters.op && entry.op !== filters.op) {
-        return false;
-    }
-    if (filters.author && entry.author !== filters.author) {
-        return false;
-    }
-    return includeByTimeWindow(candidate, filters.from, filters.to);
-}
-async function collectActivityEntries(historyDir, filters) {
-    const combined = [];
-    for (const file of await listHistoryFiles(historyDir)) {
-        const id = file.slice(0, -".jsonl".length);
-        if (filters.id && id !== filters.id) {
-            continue;
-        }
-        const entries = await readHistoryEntries(path.join(historyDir, file), id);
-        for (const entry of entries) {
-            const candidate = normalizeActivityEntry(id, entry);
-            if (includeActivityEntry(entry, candidate, filters)) {
-                combined.push(candidate);
-            }
-        }
-    }
-    return combined;
-}
-function formatCompactActivity(activity) {
-    return activity.map((entry) => ({
-        id: entry.id,
-        op: entry.op,
-        ts: entry.ts,
-        author: entry.author,
-        ...(entry.message ? { msg: entry.message } : {}),
-    }));
-}
-function boundedOperationSummary(counts) {
-    const ordered = [...counts.entries()].sort(([leftOp, leftCount], [rightOp, rightCount]) => rightCount - leftCount || leftOp.localeCompare(rightOp));
-    const visible = ordered.slice(0, 4).map(([op, count]) => `${op}:${count}`);
-    if (ordered.length > visible.length) {
-        visible.push(`+${ordered.length - visible.length}`);
-    }
-    return visible.join(",");
-}
-function buildActivityDigest(activity, itemsById) {
-    const grouped = new Map();
-    for (const entry of activity) {
-        const current = grouped.get(entry.id);
-        if (current === undefined) {
-            grouped.set(entry.id, {
-                firstTs: entry.ts,
-                lastTs: entry.ts,
-                eventCount: 1,
-                operations: new Map([[entry.op, 1]]),
-            });
-            continue;
-        }
-        current.eventCount += 1;
-        if (compareTimestampStrings(entry.ts, current.firstTs) < 0) {
-            current.firstTs = entry.ts;
-        }
-        if (compareTimestampStrings(entry.ts, current.lastTs) > 0) {
-            current.lastTs = entry.ts;
-        }
-        current.operations.set(entry.op, (current.operations.get(entry.op) ?? 0) + 1);
-    }
-    return [...grouped.entries()]
-        .map(([id, summary]) => {
-        const item = itemsById.get(id);
-        return {
-            id,
-            type: item?.type ?? "unknown",
-            status: item?.status ?? "unknown",
-            title: (item?.title ?? "(item metadata unavailable)").slice(0, 160),
-            event_count: summary.eventCount,
-            first_ts: summary.firstTs,
-            last_ts: summary.lastTs,
-            operations: boundedOperationSummary(summary.operations),
-        };
-    })
-        .sort((left, right) => compareTimestampStrings(right.last_ts, left.last_ts) ||
-        left.id.localeCompare(right.id));
-}
-function activityOperationCounts(activity) {
-    const counts = new Map();
-    for (const entry of activity) {
-        counts.set(entry.op, (counts.get(entry.op) ?? 0) + 1);
-    }
-    const ordered = [...counts.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]));
-    const visible = ordered.slice(0, 8);
-    if (visible.length < ordered.length) {
-        visible.push([
-            `+${String(ordered.length - visible.length)}`,
-            ordered
-                .slice(visible.length)
-                .reduce((total, [, count]) => total + count, 0),
-        ]);
-    }
-    return Object.fromEntries(visible);
-}
-function projectActivityRows(projectionMode, matchingActivity, limit, itemsById, projectProvenance) {
-    if (projectionMode === "digest") {
-        const matchingDigest = buildActivityDigest(matchingActivity, itemsById);
-        const activityDigest = limitEntries(matchingDigest, limit);
-        return {
-            rows: { activity_digest: activityDigest },
-            compact: false,
-            totalRows: matchingDigest.length,
-            returnedRows: activityDigest.length,
-        };
-    }
-    const activity = limitEntries(matchingActivity, limit);
-    if (projectionMode === "compact") {
-        return {
-            rows: { compact_activity: formatCompactActivity(activity) },
-            compact: true,
-            totalRows: matchingActivity.length,
-            returnedRows: activity.length,
-        };
-    }
-    if (projectionMode === "provenance") {
-        return {
-            rows: { provenance_activity: activity.map(projectProvenance) },
-            compact: false,
-            totalRows: matchingActivity.length,
-            returnedRows: activity.length,
-        };
-    }
-    return {
-        rows: { activity },
-        compact: false,
-        totalRows: matchingActivity.length,
-        returnedRows: activity.length,
-    };
-}
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export const _testOnly = {
-    parseNonEmptyFilter,
-    parseRangeBound,
-    includeByTimeWindow,
-    limitEntries,
-    readActivityString,
-    normalizeActivityEntry,
-    sortActivity,
-    listHistoryFiles,
-    buildActivityDigest,
-    activityOperationCounts,
-};
-/** Implements run activity for the public runtime surface of this module. */
-export async function runActivity(options, global) {
-    const context = await resolveActivityRuntimeContext(global);
-    const projectionMode = resolveActivityProjectionMode(options);
-    const filters = resolveActivityFilters(options, projectionMode);
-    const prepared = await prepareActivityHistoryRead(context);
-    const provenanceDimensions = resolveHistoryProvenanceDimensions(context.settings.agent_identity.harness_signals);
-    const vocabulary = context.settings.agent_identity.identity_vocabulary;
-    const matchesProvenance = compileHistoryProvenanceMatcher({
-        harness: filters.harness,
-        agentInstance: filters.agentInstance,
-        provenance: filters.provenance,
-    }, vocabulary, provenanceDimensions);
-    const matchingActivity = sortActivity(await collectActivityEntries(prepared.historyDir, filters)).filter(matchesProvenance);
-    const projected = projectActivityRows(projectionMode, matchingActivity, filters.limit, prepared.itemsById, (entry) => projectHistoryProvenance(entry, vocabulary, { itemId: entry.id }));
-    const omittedCount = projected.totalRows - projected.returnedRows;
-    return {
-        ...projected.rows,
-        compact: projected.compact,
-        projection: {
-            mode: projectionMode,
-            row_key: ACTIVITY_ROW_KEY_BY_MODE[projectionMode],
-        },
-        omission_receipt: resolveModePairedOutputOmissionReceipt("activity", projectionMode),
-        count: projected.returnedRows,
-        total_count: projected.totalRows,
-        limit: filters.limit ?? null,
-        omitted_count: omittedCount,
-        has_more: omittedCount > 0,
-        ...(projectionMode === "digest"
-            ? {
-                activity_summary: {
-                    window: { from: filters.from, to: filters.to },
-                    event_count: matchingActivity.length,
-                    item_count: projected.totalRows,
-                    author_count: new Set(matchingActivity.map((entry) => entry.author)).size,
-                    operation_counts: activityOperationCounts(matchingActivity),
-                },
-            }
-            : {}),
-        ...(options.provenanceSummary === true
-            ? {
-                provenance_summary: summarizeHistoryProvenance(matchingActivity, vocabulary, provenanceDimensions),
-            }
-            : {}),
-        applied_bound: {
-            kind: filters.limit === undefined ? "unbounded" : "limit",
-            source: filters.limitSource,
-            value: filters.limit ?? null,
-        },
-    };
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="03488490-bc4a-5988-9ceb-46800c6d7833")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{isFileMissingError}from"../../core/fs/fs-utils.js";import fs from"node:fs/promises";import path from"node:path";import{getActiveExtensionRegistrations,runActiveOnReadHooks,enforceHistoryStreamPolicyForItems,resolveItemTypeRegistry,EXIT_CODE,PmCliError,compareTimestampStrings,nowIso,resolveIsoOrRelative,listAllItemMetadataLight,resolvePmRoot,readSettings}from"../runtime-primitives.js";import{readHistoryEntries}from"../history-read.js";import{parseLimit}from"./parsers.js";import{resolveModePairedOutputOmissionReceipt}from"../output-projection.js";import{compileHistoryProvenanceMatcher,projectHistoryProvenance,resolveHistoryProvenanceDimensions,summarizeHistoryProvenance}from"../history-provenance.js";const DEFAULT_COMPACT_ACTIVITY_LIMIT=20;const DEFAULT_FULL_ACTIVITY_LIMIT=5;const DEFAULT_DIGEST_ACTIVITY_LIMIT=15;const DEFAULT_DIGEST_WINDOW="-24h";function normalizeActivityProjectionOptions(options){const normalized={...options};if(normalized.full===true){normalized.raw=true;normalized.compact=false}else if(normalized.raw===true&&normalized.compact===void 0){normalized.compact=true}delete normalized.full;return normalized}const ACTIVITY_ROW_KEY_BY_MODE={digest:"activity_digest",compact:"compact_activity",provenance:"provenance_activity",full:"activity"};function parseNonEmptyFilter(raw,flagLabel){if(raw===void 0)return void 0;const normalized=raw.trim();if(normalized.length===0){throw new PmCliError(`${flagLabel} must not be empty`,EXIT_CODE.USAGE)}return normalized}function parseRangeBound(raw,nowValue,fieldLabel){if(raw===void 0)return void 0;const normalized=raw.trim();if(normalized.length===0){throw new PmCliError("Activity time bounds must not be empty",EXIT_CODE.USAGE)}const relativeInput=fieldLabel==="--from"&&/^\d+[hdwm]$/iu.test(normalized)?`-${normalized}`:normalized;return resolveIsoOrRelative(relativeInput,new Date(nowValue),fieldLabel)}function includeByTimeWindow(entry,from,to){if(entry.ts.length===0&&(from||to)){return false}if(from&&compareTimestampStrings(entry.ts,from)<0){return false}if(to&&compareTimestampStrings(entry.ts,to)>=0){return false}return true}function limitEntries(values,limit){if(limit===void 0)return values;return values.slice(0,limit)}function readActivityString(value,fallback=""){return typeof value==="string"?value:fallback}function normalizeActivityEntry(id,entry){return{...entry,id,ts:readActivityString(entry.ts),author:readActivityString(entry.author,"unknown"),op:readActivityString(entry.op,"unknown"),patch:Array.isArray(entry.patch)?entry.patch:[],before_hash:readActivityString(entry.before_hash),after_hash:readActivityString(entry.after_hash)}}function sortActivity(entries){return[...entries].sort((a,b)=>{const byTimestamp=b.ts.localeCompare(a.ts);if(byTimestamp!==0)return byTimestamp;const byId=a.id.localeCompare(b.id);if(byId!==0)return byId;return a.op.localeCompare(b.op)})}async function listHistoryFiles(historyDir){try{return(await fs.readdir(historyDir)).filter(entry=>entry.endsWith(".jsonl")).sort((a,b)=>a.localeCompare(b))}catch(error){if(isFileMissingError(error)){return[]}throw error}}function resolveActivityProjectionMode(options){if(options.raw!==true&&options.compact!==true&&options.provenance!==true){return"digest"}if(options.provenance===true)return"provenance";if(options.compact===true||options.raw===true&&options.compact!==false){return"compact"}return"full"}function resolveActivityLimit(options,explicitLimit,projectionMode){if(options.unbounded===true)return void 0;if(explicitLimit!==void 0)return explicitLimit;if(projectionMode==="digest")return DEFAULT_DIGEST_ACTIVITY_LIMIT;if(projectionMode==="compact")return DEFAULT_COMPACT_ACTIVITY_LIMIT;return DEFAULT_FULL_ACTIVITY_LIMIT}function resolveActivityFilters(options,projectionMode){const nowValue=nowIso();const digest=projectionMode==="digest";const to=parseRangeBound(options.to??(digest?nowValue:void 0),nowValue,"--to");const from=parseRangeBound(options.from??(digest?DEFAULT_DIGEST_WINDOW:void 0),options.from===void 0&&digest?to:nowValue,"--from");if(from&&to&&compareTimestampStrings(from,to)>=0){throw new PmCliError("Activity --from must be before --to",EXIT_CODE.USAGE)}const explicitLimit=parseLimit(options.limit);if(options.unbounded===true&&explicitLimit!==void 0){throw new PmCliError("Activity --unbounded cannot be combined with --limit",EXIT_CODE.USAGE)}return{id:parseNonEmptyFilter(options.id,"Activity --id"),op:parseNonEmptyFilter(options.op,"Activity --op"),author:parseNonEmptyFilter(options.author,"Activity --author"),from,to,limit:resolveActivityLimit(options,explicitLimit,projectionMode),limitSource:options.unbounded===true||explicitLimit!==void 0?"explicit":"default",harness:options.harness,agentInstance:options.agentInstance,provenance:options.provenanceFilter}}async function resolveActivityRuntimeContext(global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);return{pmRoot,settings:await readSettings(pmRoot)}}async function prepareActivityHistoryRead(context){const typeRegistry=resolveItemTypeRegistry(context.settings,getActiveExtensionRegistrations());const items=await listAllItemMetadataLight(context.pmRoot,context.settings.item_format,typeRegistry.type_to_folder,void 0,context.settings.schema);await enforceHistoryStreamPolicyForItems({pmRoot:context.pmRoot,settings:context.settings,itemIds:items.map(item=>item.id),commandLabel:"activity"});const historyDir=path.join(context.pmRoot,"history");await runActiveOnReadHooks({path:historyDir,scope:"project"});return{historyDir,itemsById:new Map(items.map(item=>[item.id,{title:item.title,type:item.type,status:item.status}]))}}function includeActivityEntry(entry,candidate,filters){if(filters.op&&entry.op!==filters.op){return false}if(filters.author&&entry.author!==filters.author){return false}return includeByTimeWindow(candidate,filters.from,filters.to)}async function collectActivityEntries(historyDir,filters){const combined=[];for(const file of await listHistoryFiles(historyDir)){const id=file.slice(0,-".jsonl".length);if(filters.id&&id!==filters.id){continue}const entries=await readHistoryEntries(path.join(historyDir,file),id);for(const entry of entries){const candidate=normalizeActivityEntry(id,entry);if(includeActivityEntry(entry,candidate,filters)){combined.push(candidate)}}}return combined}function formatCompactActivity(activity){return activity.map(entry=>({id:entry.id,op:entry.op,ts:entry.ts,author:entry.author,...entry.message?{msg:entry.message}:{}}))}function boundedOperationSummary(counts){const ordered=[...counts.entries()].sort(([leftOp,leftCount],[rightOp,rightCount])=>rightCount-leftCount||leftOp.localeCompare(rightOp));const visible=ordered.slice(0,4).map(([op,count])=>`${op}:${count}`);if(ordered.length>visible.length){visible.push(`+${ordered.length-visible.length}`)}return visible.join(",")}function buildActivityDigest(activity,itemsById){const grouped=new Map;for(const entry of activity){const current=grouped.get(entry.id);if(current===void 0){grouped.set(entry.id,{firstTs:entry.ts,lastTs:entry.ts,eventCount:1,operations:new Map([[entry.op,1]])});continue}current.eventCount+=1;if(compareTimestampStrings(entry.ts,current.firstTs)<0){current.firstTs=entry.ts}if(compareTimestampStrings(entry.ts,current.lastTs)>0){current.lastTs=entry.ts}current.operations.set(entry.op,(current.operations.get(entry.op)??0)+1)}return[...grouped.entries()].map(([id,summary])=>{const item=itemsById.get(id);return{id,type:item?.type??"unknown",status:item?.status??"unknown",title:(item?.title??"(item metadata unavailable)").slice(0,160),event_count:summary.eventCount,first_ts:summary.firstTs,last_ts:summary.lastTs,operations:boundedOperationSummary(summary.operations)}}).sort((left,right)=>compareTimestampStrings(right.last_ts,left.last_ts)||left.id.localeCompare(right.id))}function activityOperationCounts(activity){const counts=new Map;for(const entry of activity){counts.set(entry.op,(counts.get(entry.op)??0)+1)}const ordered=[...counts.entries()].sort((left,right)=>right[1]-left[1]||left[0].localeCompare(right[0]));const visible=ordered.slice(0,8);if(visible.length<ordered.length){visible.push([`+${String(ordered.length-visible.length)}`,ordered.slice(visible.length).reduce((total,[,count])=>total+count,0)])}return Object.fromEntries(visible)}function projectActivityRows(projectionMode,matchingActivity,limit,itemsById,projectProvenance){if(projectionMode==="digest"){const matchingDigest=buildActivityDigest(matchingActivity,itemsById);const activityDigest=limitEntries(matchingDigest,limit);return{rows:{activity_digest:activityDigest},compact:false,totalRows:matchingDigest.length,returnedRows:activityDigest.length}}const activity=limitEntries(matchingActivity,limit);if(projectionMode==="compact"){return{rows:{compact_activity:formatCompactActivity(activity)},compact:true,totalRows:matchingActivity.length,returnedRows:activity.length}}if(projectionMode==="provenance"){return{rows:{provenance_activity:activity.map(projectProvenance)},compact:false,totalRows:matchingActivity.length,returnedRows:activity.length}}return{rows:{activity},compact:false,totalRows:matchingActivity.length,returnedRows:activity.length}}const _testOnly={parseNonEmptyFilter,parseRangeBound,includeByTimeWindow,limitEntries,readActivityString,normalizeActivityEntry,sortActivity,listHistoryFiles,buildActivityDigest,activityOperationCounts};async function runActivity(options,global2){const context=await resolveActivityRuntimeContext(global2);const projectionMode=resolveActivityProjectionMode(options);const filters=resolveActivityFilters(options,projectionMode);const prepared=await prepareActivityHistoryRead(context);const provenanceDimensions=resolveHistoryProvenanceDimensions(context.settings.agent_identity.harness_signals);const vocabulary=context.settings.agent_identity.identity_vocabulary;const matchesProvenance=compileHistoryProvenanceMatcher({harness:filters.harness,agentInstance:filters.agentInstance,provenance:filters.provenance},vocabulary,provenanceDimensions);const matchingActivity=sortActivity(await collectActivityEntries(prepared.historyDir,filters)).filter(matchesProvenance);const projected=projectActivityRows(projectionMode,matchingActivity,filters.limit,prepared.itemsById,entry=>projectHistoryProvenance(entry,vocabulary,{itemId:entry.id}));const omittedCount=projected.totalRows-projected.returnedRows;return{...projected.rows,compact:projected.compact,projection:{mode:projectionMode,row_key:ACTIVITY_ROW_KEY_BY_MODE[projectionMode]},omission_receipt:resolveModePairedOutputOmissionReceipt("activity",projectionMode),count:projected.returnedRows,total_count:projected.totalRows,limit:filters.limit??null,omitted_count:omittedCount,has_more:omittedCount>0,...projectionMode==="digest"?{activity_summary:{window:{from:filters.from,to:filters.to},event_count:matchingActivity.length,item_count:projected.totalRows,author_count:new Set(matchingActivity.map(entry=>entry.author)).size,operation_counts:activityOperationCounts(matchingActivity)}}:{},...options.provenanceSummary===true?{provenance_summary:summarizeHistoryProvenance(matchingActivity,vocabulary,provenanceDimensions)}:{},applied_bound:{kind:filters.limit===void 0?"unbounded":"limit",source:filters.limitSource,value:filters.limit??null}}}export{_testOnly,normalizeActivityProjectionOptions,runActivity};
 //# sourceMappingURL=activity.js.map
-//# debugId=7005305a-5fd4-56b8-a0a0-5612e8bf48cc

package/dist/sdk/query/aggregate.d.ts

@@ -22,6 +22,12 @@ type AggregateListedItem = {
 export interface AggregateOptions {
     /** Value that configures or reports group by for this contract. */
     groupBy?: string;
+    /** Group array fields by distinct element (default), or by their entire normalized tuple. */
+    setMode?: string;
+    /** Maximum emitted groups, defaulting to 50 independently of input item count. */
+    limit?: string | number;
+    /** Resume after the exact group cursor returned by the preceding page. */
+    after?: string;
     /** Value that configures or reports count for this contract. */
     count?: boolean;
     /** Value that configures or reports completion for this contract. */
@@ -86,15 +92,25 @@ export interface AggregateResult {
     groups: AggregateRow[];
     /** Value that configures or reports count for this contract. */
     count: number;
+    /** Number of groups in this page. */
+    returned_count: number;
+    /** Whether additional groups remain after this page. */
+    truncated: boolean;
+    /** Exact group-key cursor for the next page, or null when complete. */
+    next_after: string | null;
     /** Value that configures or reports totals for this contract. */
     totals: {
         items_considered: number;
         items_grouped: number;
         items_skipped_unparented: number;
+        /** Membership contributions; may exceed items_grouped when an item belongs to several groups. */
+        group_memberships: number;
     };
     /** Value that configures or reports filters for this contract. */
     filters: {
         group_by: AggregateGroupField[];
+        /** Declared interpretation of every set-valued grouping dimension. */
+        set_mode: "element" | "tuple";
         count: boolean;
         completion: boolean;
         sum?: string | null;