@octocodeai/octocode-tools-core 16.6.2 → 16.6.3

package/dist/oql/schema.d.ts

@@ -92,11 +92,13 @@ export declare const QueryControlsSchema: z.ZodObject<{
         matchPage: z.ZodOptional<z.ZodNumber>;
         sort: z.ZodOptional<z.ZodEnum<{
             path: "path";
+            size: "size";
             created: "created";
+            name: "name";
             modified: "modified";
+            accessed: "accessed";
             relevance: "relevance";
             matchCount: "matchCount";
-            accessed: "accessed";
         }>>;
         sortReverse: z.ZodOptional<z.ZodBoolean>;
         rankingProfile: z.ZodOptional<z.ZodString>;
@@ -204,11 +206,13 @@ export declare const OqlQuerySchema: z.ZodObject<{
             matchPage: z.ZodOptional<z.ZodNumber>;
             sort: z.ZodOptional<z.ZodEnum<{
                 path: "path";
+                size: "size";
                 created: "created";
+                name: "name";
                 modified: "modified";
+                accessed: "accessed";
                 relevance: "relevance";
                 matchCount: "matchCount";
-                accessed: "accessed";
             }>>;
             sortReverse: z.ZodOptional<z.ZodBoolean>;
             rankingProfile: z.ZodOptional<z.ZodString>;
@@ -325,11 +329,13 @@ export declare const OqlBatchSchema: z.ZodObject<{
                 matchPage: z.ZodOptional<z.ZodNumber>;
                 sort: z.ZodOptional<z.ZodEnum<{
                     path: "path";
+                    size: "size";
                     created: "created";
+                    name: "name";
                     modified: "modified";
+                    accessed: "accessed";
                     relevance: "relevance";
                     matchCount: "matchCount";
-                    accessed: "accessed";
                 }>>;
                 sortReverse: z.ZodOptional<z.ZodBoolean>;
                 rankingProfile: z.ZodOptional<z.ZodString>;
@@ -452,11 +458,13 @@ export declare const OqlCanonicalInputSchema: z.ZodUnion<readonly [z.ZodObject<{
             matchPage: z.ZodOptional<z.ZodNumber>;
             sort: z.ZodOptional<z.ZodEnum<{
                 path: "path";
+                size: "size";
                 created: "created";
+                name: "name";
                 modified: "modified";
+                accessed: "accessed";
                 relevance: "relevance";
                 matchCount: "matchCount";
-                accessed: "accessed";
             }>>;
             sortReverse: z.ZodOptional<z.ZodBoolean>;
             rankingProfile: z.ZodOptional<z.ZodString>;
@@ -572,11 +580,13 @@ export declare const OqlCanonicalInputSchema: z.ZodUnion<readonly [z.ZodObject<{
                 matchPage: z.ZodOptional<z.ZodNumber>;
                 sort: z.ZodOptional<z.ZodEnum<{
                     path: "path";
+                    size: "size";
                     created: "created";
+                    name: "name";
                     modified: "modified";
+                    accessed: "accessed";
                     relevance: "relevance";
                     matchCount: "matchCount";
-                    accessed: "accessed";
                 }>>;
                 sortReverse: z.ZodOptional<z.ZodBoolean>;
                 rankingProfile: z.ZodOptional<z.ZodString>;
@@ -690,11 +700,13 @@ export declare const OqlDisplayQuerySchema: z.ZodObject<{
             matchPage: z.ZodOptional<z.ZodNumber>;
             sort: z.ZodOptional<z.ZodEnum<{
                 path: "path";
+                size: "size";
                 created: "created";
+                name: "name";
                 modified: "modified";
+                accessed: "accessed";
                 relevance: "relevance";
                 matchCount: "matchCount";
-                accessed: "accessed";
             }>>;
             sortReverse: z.ZodOptional<z.ZodBoolean>;
             rankingProfile: z.ZodOptional<z.ZodString>;
@@ -822,11 +834,13 @@ export declare const OqlInputQuerySchema: z.ZodObject<{
             matchPage: z.ZodOptional<z.ZodNumber>;
             sort: z.ZodOptional<z.ZodEnum<{
                 path: "path";
+                size: "size";
                 created: "created";
+                name: "name";
                 modified: "modified";
+                accessed: "accessed";
                 relevance: "relevance";
                 matchCount: "matchCount";
-                accessed: "accessed";
             }>>;
             sortReverse: z.ZodOptional<z.ZodBoolean>;
             rankingProfile: z.ZodOptional<z.ZodString>;
@@ -967,11 +981,13 @@ export declare const OqlSearchInputSchema: z.ZodObject<{
             matchPage: z.ZodOptional<z.ZodNumber>;
             sort: z.ZodOptional<z.ZodEnum<{
                 path: "path";
+                size: "size";
                 created: "created";
+                name: "name";
                 modified: "modified";
+                accessed: "accessed";
                 relevance: "relevance";
                 matchCount: "matchCount";
-                accessed: "accessed";
             }>>;
             sortReverse: z.ZodOptional<z.ZodBoolean>;
             rankingProfile: z.ZodOptional<z.ZodString>;

package/dist/oql/schemeText.d.ts

@@ -36,20 +36,20 @@ export declare const OQL_SCHEMA_DOC: {
     readonly agentBestPractices: readonly ["Start with cheap orientation: --tree, --search path, --view discovery, or --content-view symbols.", "Then narrow and read exact evidence: --match-string, --start-line/--end-line, --char-offset/--char-length, or --content-view exact.", "Use snippets as discovery only; make decisions from exact content, PR/commit metadata, or LSP/graph proof.", "For semantics, run documentSymbols first to get line anchors, then references/callers/hover with symbolName + lineHint.", "For GitHub zero rows / providerUnindexed, do NOT claim absence — follow evidenceSemantics.providerUnindexed (verify path with structure, then materialize a bounded path).", "Read evidence.answerReady, evidence.complete, diagnostics, pagination, and next.* before concluding."];
     readonly quickStart: {
         readonly 'text search (local)': "search \"functionName\" ./src";
-        readonly 'text search (GitHub)': "search \"functionName\" facebook/react";
+        readonly 'text search (GitHub)': "search \"functionName\" vercel/next.js";
         readonly 'package lookup (npm)': "search zod --target packages";
-        readonly 'PR deep read (GitHub)': "search facebook/react#1 --target pullRequests --comments --patches";
-        readonly 'commit history (GitHub)': "search facebook/react/packages/react/src --target commits --since 2024-01-01T00:00:00Z";
-        readonly 'browse a tree (local dir or owner/repo)': "search ./src --tree   |   search facebook/react --tree";
-        readonly 'read a file (local or owner/repo/path)': "search ./src/index.ts   |   search facebook/react/packages/react/src/index.js";
-        readonly 'read a remote file (exact)': "search facebook/react/README.md --content-view exact";
+        readonly 'PR deep read (GitHub)': "search vercel/next.js#1 --target pullRequests --comments --patches";
+        readonly 'commit history (GitHub)': "search vercel/next.js/packages/next/src --target commits --since 2024-01-01T00:00:00Z";
+        readonly 'browse a tree (local dir or owner/repo)': "search ./src --tree   |   search vercel/next.js --tree";
+        readonly 'read a file (local or owner/repo/path)': "search ./src/index.ts   |   search vercel/next.js/packages/next/src/server/config.ts";
+        readonly 'read a remote file (exact)': "search vercel/next.js/README.md --content-view exact";
         readonly 'semantics (local/materialized)': "search ./src/index.ts --op documentSymbols   |   search ./src/index.ts --op references --symbol runCLI --line 42";
         readonly 'artifact inspect/list': "search app.tgz --target artifacts --list   |   search dist/server.node --target artifacts --inspect";
-        readonly 'PR diff (GitHub)': "search facebook/react#123 --target diff   |   search facebook/react --target diff --pr 123";
+        readonly 'PR diff (GitHub)': "search vercel/next.js#123 --target diff   |   search vercel/next.js --target diff --pr 123";
         readonly 'two-ref / two-file diff': "search src/a.ts src/b.ts --target diff   |   search owner/repo --target diff --base-ref <sha> --head-ref <sha> --path <file>";
         readonly 'structural AST (local \u2014 needs full node shape)': "search --pattern \"function $NAME($$$ARGS) { $$$BODY }\" ./src --lang ts";
-        readonly 'structural AST (GitHub \u2014 clones bounded subtree)': "search --pattern \"function $NAME($$$ARGS) { $$$BODY }\" facebook/react/packages --lang js --materialize auto";
-        readonly 'GitHub index miss recovery': "search useState packages/react/src --repo facebook/react --materialize required   |   clone facebook/react/packages/react/src   |   cache fetch facebook/react packages/react/src --depth tree";
+        readonly 'structural AST (GitHub \u2014 clones bounded subtree)': "search --pattern \"function $NAME($$$ARGS) { $$$BODY }\" vercel/next.js/packages/next/src --lang ts --materialize auto";
+        readonly 'GitHub index miss recovery': "search useState packages/next/src --repo vercel/next.js --materialize required   |   clone vercel/next.js/packages/next/src   |   cache fetch vercel/next.js packages/next/src --depth tree";
         readonly 'dead-code triage (research)': "search --query '{\"schema\":\"oql\",\"target\":\"research\",\"from\":{\"kind\":\"local\",\"path\":\"./src\"},\"params\":{\"intent\":\"reachability\",\"facets\":[\"symbols\",\"files\"]},\"itemsPerPage\":1,\"page\":1}'";
         readonly 'LSP-proven dead symbols (graph)': "search --query '{\"schema\":\"oql\",\"target\":\"graph\",\"from\":{\"kind\":\"local\",\"path\":\"./src\"},\"params\":{\"intent\":\"reachability\",\"facets\":[\"symbols\"],\"proof\":\"lsp\",\"proofLimit\":5,\"includePackets\":true},\"page\":1,\"itemsPerPage\":10}'";
         readonly 'OQL full-schema reference': "search --scheme";
@@ -87,7 +87,7 @@ export declare const OQL_SCHEMA_DOC: {
         readonly params: "target options (validated by OQL for common fields and by the backing tool exhaustively) — see params hints below";
         readonly select: "string[] projection of result/continuation fields";
         readonly view: "discovery | paginated | detailed";
-        readonly controls: "{ search?: { countLinesPerFile?, countMatchesPerFile?, onlyMatching?, unique?, countUnique?, contextLines?, invertMatch?, matchWindow?, matchContentLength?, maxMatchesPerFile?, matchPage?, sort?, sortReverse?, rankingProfile?, debugRanking? }, budget?: { maxFiles?, maxCandidates?, maxBytes?, maxMaterializedBytes?, maxPlanNodes?, maxBooleanExpansion?, timeoutMs? } } — output/cost controls";
+        readonly controls: "{ search?: { countLinesPerFile?, countMatchesPerFile?, onlyMatching?, unique?, countUnique?, contextLines?, invertMatch?, matchWindow?, matchContentLength?, maxMatchesPerFile?, matchPage?, sort?:\"relevance\"|\"matchCount\"|\"path\"|\"modified\"|\"accessed\"|\"created\"|\"size\"|\"name\", sortReverse?, rankingProfile?, debugRanking? }, budget?: { maxFiles?, maxCandidates?, maxBytes?, maxMaterializedBytes?, maxPlanNodes?, maxBooleanExpansion?, timeoutMs? } } — output/cost controls; sort values \"size\"/\"name\" apply to target:\"files\" only (lowered to localFindFiles sortBy), the rest are code-search sorts";
         readonly limit: "number — total result cap where supported. Prefer itemsPerPage for paged research/graph/file-history continuations.";
         readonly page: "number — top-level page number for OQL windowing/continuations";
         readonly itemsPerPage: "number — page size for the target primary result domain. For code search this may be matched files, not individual matches; per-file match paging uses controls.search.matchPage. Per-target params expose backing-tool sub-pages only (filePage/commentPage/commitPage, entryPageNumber, scanOffset, etc.).";
@@ -109,8 +109,9 @@ export declare const OQL_SCHEMA_DOC: {
         readonly text: "{ kind:\"text\", value, case?, wholeWord? }";
         readonly regex: "{ kind:\"regex\", value, dialect?:\"rust\"|\"pcre2\"|\"provider\", case?, wholeWord?, multiline?, dotAll? }";
         readonly structural: "{ kind:\"structural\", lang, pattern? | rule? } (exactly one; rule is a JSON object or grep-compatible YAML rule string) — pattern must match the COMPLETE node, so include the parts the real node has: a fn WITH a return type only matches if the pattern has one too (`function $N($$$A): $R { $$$B }`); omitting it returns 0. Shapes: `function $N($$$A) { $$$B }` (no-return-type fn), `($$$A) => $$$B` (arrow, block+expression), `$F($$$A)` (call), `$O.$M($$$A)` (method). For \"find symbol X\" the ROBUST form is a rule, not a pattern: `{ kind:\"function_declaration\", has:{ pattern:\"X\" } }`. 0 matches + no parse error = pattern shape ≠ real node (add `: $R`, or switch to a rule). Note: $$$-only patterns skip files with no literal anchor → low counts; add a literal name or use a regex where.";
-        readonly field: "{ kind:\"field\", field:\"path\"|\"basename\"|\"extension\"|\"size\"|\"modified\"|\"accessed\"|\"empty\"|\"permissions\"|\"executable\"|\"readable\"|\"writable\"|\"entryType\", op:\"=\"|\"!=\"|\"in\"|\"exists\"|\"glob\"|\"regex\"|\">\"|\">=\"|\"<\"|\"<=\"|\"within\"|\"before\", value? } (use symbolic ops like \"=\"; aliases such as \"eq\" are invalid; there is no \"contains\" op — use op:\"glob\", value:\"*term*\" or op:\"regex\"; \"within\"/\"before\" compare modified/accessed times; empty/executable/readable/writable are boolean file attributes paired with op:\"exists\" or op:\"=\")";
+        readonly field: "{ kind:\"field\", field:\"path\"|\"basename\"|\"extension\"|\"size\"|\"modified\"|\"accessed\"|\"empty\"|\"permissions\"|\"executable\"|\"readable\"|\"writable\"|\"entryType\", op:\"=\"|\"!=\"|\"in\"|\"exists\"|\"glob\"|\"regex\"|\">\"|\">=\"|\"<\"|\"<=\"|\"within\"|\"before\", value? } (use symbolic ops like \"=\"; aliases such as \"eq\" are invalid; there is no \"contains\" op — use op:\"glob\", value:\"*term*\" or op:\"regex\"; \"within\"/\"before\" compare modified/accessed times; empty/executable/readable/writable are boolean file attributes paired with op:\"exists\" or op:\"=\") SCOPE: field predicates evaluate file attributes, so they run on target:\"files\" (and mixed into files-lane booleans); target:\"code\" rejects a bare field predicate with unsupportedPredicate — use text/regex/structural for code content, or target:\"files\" for file discovery.";
         readonly boolean: "{ kind:\"all\"|\"any\", of: Predicate[] } | { kind:\"not\", predicate }";
+        readonly booleanSugar: "Top-level sugar keys lower to canonical booleans at normalize time: and:[...]→all, or:[...]→any, noneOf:[...]→not(any), xor:[a,b]→any(all(a,not b),all(not a,b)), oneOf:[...]→exactly-one expansion (bounded by controls.budget.maxBooleanExpansion), invert:true→not(where). Prefer canonical all/any/not in programmatic queries; sugar is for terse hand-written ones.";
     };
     readonly batch: {
         readonly queries: "OqlQuery[] (1-5)";

package/dist/oql/transformers/github/common.d.ts

@@ -1,4 +1,10 @@
-import type { OqlQuery, QueryScope, QuerySource } from '../../types.js';
+import type { OqlQuery, Predicate, QueryScope, QuerySource } from '../../types.js';
+/**
+ * Collect the leaf predicates (text/regex/structural/field) of a `where`
+ * tree. Mirrors the planner's walk without importing planner.ts (cycle risk);
+ * used to verify a provider transformer consumed every routed leaf.
+ */
+export declare function leafPredicates(where: Predicate): Predicate[];
 export declare function splitGithubSource(source: QuerySource | undefined): {
     owner?: string;
     repo?: string;

package/dist/oql/types.d.ts

@@ -15,6 +15,16 @@ export declare const ACTIVE_TARGETS: readonly OqlActiveTarget[];
 export declare const RESERVED_TARGETS: readonly OqlReservedTarget[];
 /** Targets that do not need a code corpus (provider/registry discovery). */
 export declare const CORPUS_OPTIONAL_TARGETS: readonly OqlActiveTarget[];
+/**
+ * Which `controls.search.sort` values each lane can actually execute
+ * (files: localFindFiles sortBy; code: code-search ranking sorts). Single
+ * source for shorthand lowering and the planner's inapplicable-sort warning —
+ * a value outside the target's set is IGNORED by the backend, never an error.
+ */
+export declare const SEARCH_SORTS_BY_TARGET: {
+    readonly code: readonly ["relevance", "matchCount", "path", "modified", "accessed", "created"];
+    readonly files: readonly ["size", "name", "path", "modified"];
+};
 export type PredicateId = string;
 export type QuerySource = {
     kind: 'local';
@@ -150,7 +160,7 @@ export interface QueryControls {
         matchContentLength?: number;
         maxMatchesPerFile?: number;
         matchPage?: number;
-        sort?: 'relevance' | 'matchCount' | 'path' | 'modified' | 'accessed' | 'created';
+        sort?: 'relevance' | 'matchCount' | 'path' | 'modified' | 'accessed' | 'created' | 'size' | 'name';
         sortReverse?: boolean;
         rankingProfile?: string;
         debugRanking?: boolean;
@@ -238,7 +248,7 @@ export interface OqlInputBatch {
     explain?: boolean;
 }
 export type OqlSearchInput = OqlInputQuery | OqlInputBatch;
-export type DiagnosticCode = 'invalidQuery' | 'ambiguousSugar' | 'unknownField' | 'unsupportedTarget' | 'unsupportedPredicate' | 'unsupportedBoolean' | 'unsupportedScope' | 'negativeUniverseRequired' | 'residualNotExact' | 'fieldTypeMismatch' | 'requiresMaterialization' | 'vendorNoEquivalent' | 'lossyTransform' | 'unsupportedVendorPredicate' | 'responseShapeMismatch' | 'materializationNotAllowed' | 'materializationFailed' | 'providerUnindexed' | 'providerSemanticsApproximate' | 'partialResult' | 'contentTruncated' | 'matchTruncated' | 'planTruncated' | 'budgetExhausted' | 'parserFailed' | 'partialParse' | 'signatureUnsupported' | 'lspUnavailable' | 'staleCache' | 'sanitized' | 'rateLimited' | 'zeroMatches';
+export type DiagnosticCode = 'invalidQuery' | 'ambiguousSugar' | 'unknownField' | 'unsupportedTarget' | 'unsupportedPredicate' | 'unsupportedBoolean' | 'unsupportedScope' | 'negativeUniverseRequired' | 'residualNotExact' | 'fieldTypeMismatch' | 'requiresMaterialization' | 'vendorNoEquivalent' | 'lossyTransform' | 'unsupportedVendorPredicate' | 'responseShapeMismatch' | 'materializationNotAllowed' | 'materializationFailed' | 'providerUnindexed' | 'providerSemanticsApproximate' | 'partialResult' | 'contentTruncated' | 'matchTruncated' | 'planTruncated' | 'budgetExhausted' | 'parserFailed' | 'partialParse' | 'signatureUnsupported' | 'lspUnavailable' | 'staleCache' | 'sanitized' | 'rateLimited' | 'authRequired' | 'zeroMatches' | 'symbolNotFound';
 export interface OqlDiagnostic {
     code: DiagnosticCode;
     severity: 'info' | 'warning' | 'error';

package/dist/responses.d.ts

@@ -1,47 +1,16 @@
 import { CallToolResult } from '@modelcontextprotocol/sdk/types';
 import type { BulkToolResponse } from './types/bulk.js';
 import type { StructuredToolResponse } from './types/toolResults.js';
-import type { RoleContentBlock, RoleBasedResultOptions } from './types/responseTypes.js';
-export { StatusEmojis } from './types/responseTypes.js';
-export type { ContentRole, RoleContentBlock, RoleBasedResultOptions, RoleAnnotations, } from './types/responseTypes.js';
 export type CallToolResultOutputMode = 'text' | 'json';
 export declare function createResult(options: {
     data: unknown;
     instructions?: string;
     isError?: boolean;
 }): CallToolResult;
-export declare const ContentBuilder: {
-    system(text: string, priority?: number): RoleContentBlock;
-    assistant(text: string, priority?: number): RoleContentBlock;
-    user(text: string, priority?: number): RoleContentBlock;
-    data(data: unknown, format?: "yaml" | "json"): RoleContentBlock;
-};
-export declare const StatusEmoji: {
-    readonly success: "✅";
-    readonly empty: "📭";
-    readonly error: "❌";
-    readonly partial: "⚠️";
-    readonly searching: "🔍";
-    readonly loading: "⏳";
-    readonly info: "ℹ️";
-    readonly file: "📄";
-    readonly folder: "📁";
-    readonly page: "📃";
-    readonly definition: "🎯";
-    readonly reference: "🔗";
-    readonly call: "📞";
-};
-export declare function createRoleBasedResult(options: RoleBasedResultOptions): CallToolResult;
-export declare const QuickResult: {
-    success(summary: string, data: unknown, hints?: string[]): CallToolResult;
-    empty(message: string, hints?: string[]): CallToolResult;
-    error(error: string, details?: unknown): CallToolResult;
-    paginated(summary: string, data: unknown, pagination: {
-        page: number;
-        total: number;
-        hasMore: boolean;
-    }, hints?: string[]): CallToolResult;
-};
 export declare function sanitizeStructuredContent(obj: unknown): unknown;
 export declare function formatCallToolResultForOutput(result: Pick<CallToolResult, 'content' | 'structuredContent' | 'isError'>, outputMode: CallToolResultOutputMode): string;
 export declare function createResponseFormat(responseData: StructuredToolResponse | BulkToolResponse, keysPriority?: string[]): string;
+export declare function cleanJsonObject(obj: unknown, context?: {
+    inFilesObject?: boolean;
+    depth?: number;
+}): unknown;