@spences10/pi-context 0.0.10 → 0.0.12

package/dist/context-format.d.ts

@@ -0,0 +1,11 @@
+import { type ContextListResult, type ContextPurgeDetails, type ContextSearchResult, type ContextStats } from './store.js';
+export declare function format_search_results(results: ContextSearchResult[]): string;
+export declare function format_list_results(results: ContextListResult[]): string;
+export declare function format_purge_details(details: ContextPurgeDetails): string;
+export declare function format_stats(stats: ContextStats): string;
+export declare function format_timestamp(timestamp: number | null): string;
+export declare function format_days(days: number | null): string;
+export declare function format_max_mb(max_mb: number | null): string;
+export declare function format_kib(bytes: number): string;
+export declare function format_output_limit(bytes: number, lines: number): string;
+export declare function format_context_settings_status(stats: ContextStats): string;

package/dist/context-format.js

@@ -0,0 +1,122 @@
+import { CONTEXT_SETTINGS_PRESETS, get_context_capture_limits, get_context_mcp_output_limits, get_context_settings_config_path, load_context_settings_config, } from './config.js';
+import { is_context_sidecar_enabled, } from './store.js';
+export function format_search_results(results) {
+    if (results.length === 0)
+        return 'No indexed context matched.';
+    return results
+        .map((result, index) => [
+        `## ${index + 1}. ${result.title ?? result.chunk_id}`,
+        `Source: ${result.source_id} • Chunk: ${result.chunk_id} • Tool: ${result.tool_name}`,
+        '',
+        result.content,
+    ].join('\n'))
+        .join('\n\n---\n\n');
+}
+export function format_list_results(results) {
+    if (results.length === 0)
+        return 'No indexed context sources found.';
+    return results
+        .map((result) => [
+        `## ${result.source_id}`,
+        `Created: ${new Date(result.created_at).toISOString()} • Tool: ${result.tool_name}`,
+        `Size: ${result.bytes} bytes, ${result.lines} lines, ${result.chunk_count} chunks`,
+        `Project: ${result.project_path ?? '(none)'}`,
+        `Session: ${result.session_id ?? '(none)'}`,
+        result.input_summary
+            ? `Input: ${result.input_summary}`
+            : undefined,
+        result.first_chunk_title
+            ? `First chunk: ${result.first_chunk_title}`
+            : undefined,
+        result.preview ? `Preview: ${result.preview}` : undefined,
+    ]
+        .filter(Boolean)
+        .join('\n'))
+        .join('\n\n');
+}
+export function format_purge_details(details) {
+    const filters = [
+        details.source_id ? `source_id=${details.source_id}` : undefined,
+        details.project_path !== undefined
+            ? `project_path=${details.project_path ?? '(none)'}`
+            : undefined,
+        details.session_id !== undefined
+            ? `session_id=${details.session_id ?? '(none)'}`
+            : undefined,
+        details.older_than_days !== undefined
+            ? `older_than_days=${details.older_than_days}`
+            : undefined,
+    ]
+        .filter(Boolean)
+        .join(', ');
+    return `Deleted ${details.deleted} context source(s).${filters ? ` Filters: ${filters}.` : ''}`;
+}
+export function format_stats(stats) {
+    const scoped = stats.scope_project_path || stats.scope_session_id;
+    return [
+        '## context-sidecar stats',
+        '',
+        `- Enabled: ${is_context_sidecar_enabled()}`,
+        scoped
+            ? `- Scope: project=${stats.scope_project_path ?? '(none)'}, session=${stats.scope_session_id ?? '(none)'}`
+            : '- Scope: global',
+        `- Scoped sources: ${stats.sources}`,
+        `- Scoped chunks: ${stats.chunks}`,
+        `- Scoped raw bytes stored: ${stats.bytes_stored}`,
+        `- Global sources: ${stats.global_sources}`,
+        `- Global chunks: ${stats.global_chunks}`,
+        `- Global raw bytes stored: ${stats.global_bytes_stored}`,
+        `- Bytes returned: ${stats.bytes_returned}`,
+        `- Bytes saved: ${stats.bytes_saved}`,
+        `- Reduction: ${stats.reduction_pct}%`,
+        `- DB bytes: ${stats.total_bytes}`,
+        `- Scoped oldest source: ${format_timestamp(stats.oldest_created_at)}`,
+        `- Scoped newest source: ${format_timestamp(stats.newest_created_at)}`,
+        `- Global oldest source: ${format_timestamp(stats.global_oldest_created_at)}`,
+        `- Global newest source: ${format_timestamp(stats.global_newest_created_at)}`,
+        `- Retention days: ${stats.retention_days ?? 'disabled'}`,
+        `- Purge on shutdown: ${stats.purge_on_shutdown}`,
+        `- Max DB size: ${stats.max_mb === null ? 'disabled' : `${stats.max_mb} MiB`}`,
+    ].join('\n');
+}
+export function format_timestamp(timestamp) {
+    return timestamp === null
+        ? '(none)'
+        : new Date(timestamp).toISOString();
+}
+export function format_days(days) {
+    return days === null ? 'disabled' : `${days} day(s)`;
+}
+export function format_max_mb(max_mb) {
+    return max_mb === null ? 'disabled' : `${max_mb} MiB`;
+}
+export function format_kib(bytes) {
+    return `${Math.round(bytes / 1024)} KiB`;
+}
+export function format_output_limit(bytes, lines) {
+    return `${format_kib(bytes)} / ${lines} lines`;
+}
+export function format_context_settings_status(stats) {
+    const saved = load_context_settings_config();
+    const capture_limits = get_context_capture_limits();
+    const mcp_limits = get_context_mcp_output_limits();
+    return [
+        '## context-sidecar settings',
+        '',
+        `- Config path: ${get_context_settings_config_path()}`,
+        `- Saved preset: ${saved?.preset ?? '(none; using built-in defaults)'}`,
+        `- Effective retention: ${format_days(stats.retention_days)}`,
+        `- Effective max size: ${format_max_mb(stats.max_mb)}`,
+        `- Effective purge on shutdown: ${stats.purge_on_shutdown}`,
+        `- Effective tool capture threshold: ${format_output_limit(capture_limits.max_bytes, capture_limits.max_lines)}`,
+        `- Effective MCP capture threshold: ${format_output_limit(mcp_limits.max_bytes, mcp_limits.max_lines)}`,
+        '',
+        'Presets:',
+        ...Object.entries(CONTEXT_SETTINGS_PRESETS).map(([key, preset]) => `- ${key}: ${preset.description}`),
+        '',
+        'Usage:',
+        '- /context settings <preset>',
+        '- /context settings custom <days|off> <max-mb|off> [capture-kb] [capture-lines] [purge-on-shutdown]',
+    ].join('\n');
+}
+//# sourceMappingURL=context-format.js.map

package/dist/context-format.js.map

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

package/dist/context-scope.d.ts

@@ -0,0 +1,10 @@
+import type { ExtensionCommandContext } from '@earendil-works/pi-coding-agent';
+import type { ContextScopeOptions } from './store.js';
+export declare function is_text_content(item: unknown): item is {
+    type: 'text';
+    text: string;
+};
+export declare function summarize_tool_input(input: unknown): string | null;
+export declare function should_skip_tool(tool_name: string): boolean;
+export declare function session_id_from_context(ctx?: Pick<ExtensionCommandContext, 'sessionManager'>): string | null;
+export declare function scope_from_context(ctx?: Pick<ExtensionCommandContext, 'cwd' | 'sessionManager'>): ContextScopeOptions;

package/dist/context-scope.js

@@ -0,0 +1,44 @@
+export function is_text_content(item) {
+    return (!!item &&
+        typeof item === 'object' &&
+        item.type === 'text' &&
+        typeof item.text === 'string');
+}
+export function summarize_tool_input(input) {
+    if (!input || typeof input !== 'object')
+        return null;
+    try {
+        const json = JSON.stringify(input);
+        return json.length > 500 ? `${json.slice(0, 497)}...` : json;
+    }
+    catch {
+        return null;
+    }
+}
+export function should_skip_tool(tool_name) {
+    // Coverage policy:
+    // - context_* tools are retrieval/maintenance output; indexing them would
+    //   recurse and make the sidecar harder to reason about.
+    // - team output is coordination state, not bulky artifact content; keep it in
+    //   team/pirecall surfaces rather than duplicating mailbox/task state here.
+    // - MCP receipts are produced before generic tool_result hooks; the hook also
+    //   ignores existing [context-sidecar] receipts so direct MCP storage is not
+    //   indexed a second time.
+    return (tool_name === 'context_search' ||
+        tool_name === 'context_get' ||
+        tool_name === 'context_list' ||
+        tool_name === 'context_stats' ||
+        tool_name === 'context_purge' ||
+        tool_name === 'team');
+}
+export function session_id_from_context(ctx) {
+    const manager = ctx?.sessionManager;
+    return (manager?.getSessionFile?.() ?? manager?.getSessionId?.() ?? null);
+}
+export function scope_from_context(ctx) {
+    return {
+        project_path: ctx?.cwd ?? process.cwd(),
+        session_id: session_id_from_context(ctx),
+    };
+}
+//# sourceMappingURL=context-scope.js.map

package/dist/context-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-scope.js","sourceRoot":"","sources":["../src/context-scope.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,eAAe,CAC9B,IAAa;IAEb,OAAO,CACN,CAAC,CAAC,IAAI;QACN,OAAO,IAAI,KAAK,QAAQ;QACvB,IAA2B,CAAC,IAAI,KAAK,MAAM;QAC5C,OAAQ,IAA2B,CAAC,IAAI,KAAK,QAAQ,CACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IAClD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IACjD,mBAAmB;IACnB,0EAA0E;IAC1E,yDAAyD;IACzD,8EAA8E;IAC9E,4EAA4E;IAC5E,8EAA8E;IAC9E,6EAA6E;IAC7E,2BAA2B;IAC3B,OAAO,CACN,SAAS,KAAK,gBAAgB;QAC9B,SAAS,KAAK,aAAa;QAC3B,SAAS,KAAK,cAAc;QAC5B,SAAS,KAAK,eAAe;QAC7B,SAAS,KAAK,eAAe;QAC7B,SAAS,KAAK,MAAM,CACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACtC,GAAqD;IAErD,MAAM,OAAO,GAAG,GAAG,EAAE,cAAc,CAAC;IACpC,OAAO,CACN,OAAO,EAAE,cAAc,EAAE,EAAE,IAAI,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,IAAI,CAChE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CACjC,GAA6D;IAE7D,OAAO;QACN,YAAY,EAAE,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QACvC,UAAU,EAAE,uBAAuB,CAAC,GAAG,CAAC;KACxC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
 export default function context_sidecar(pi: ExtensionAPI): void;
-export { CONTEXT_SETTINGS_PRESETS, context_settings_from_preset, get_context_capture_limits, get_context_mcp_output_limits, get_context_settings_config_path, load_context_settings_config, save_context_settings_config, } from './config.js';
+export { context_settings_from_preset, CONTEXT_SETTINGS_PRESETS, get_context_capture_limits, get_context_mcp_output_limits, get_context_settings_config_path, load_context_settings_config, save_context_settings_config, } from './config.js';
 export type { ContextOutputLimits, ContextSettingsConfig, ContextSettingsPreset, ContextSettingsValues, } from './config.js';
 export { get_context_store, is_context_sidecar_enabled, maybe_store_context_output, parse_context_retention_policy, set_context_sidecar_enabled, should_index_text, } from './store.js';
 export type { ContextCleanupResult, ContextListResult, ContextPurgeDetails, ContextRetentionPolicy, ContextScopeOptions, ContextSearchResult, ContextStats, StoreContextInput, StoredContextOutput, } from './store.js';