Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript

Skill resolver: export-surface goldens carry the new library exports, and the CLI socket check classifies GBRAIN_BUILD_COMMIT

garrytan92bac3b363ed
diff --git a/test/cli-socket.test.ts b/test/cli-socket.test.ts
index b9e6642d0b..23cace07e4 100644
--- a/test/cli-socket.test.ts
+++ b/test/cli-socket.test.ts
@@ -86,7 +86,7 @@ const NOT_READ_BEHAVIOR_PREFIXES = [
'GBRAIN_PROGRESSIVE_BATCH_', 'GBRAIN_QUEUE_', 'GBRAIN_SETUP_', 'GBRAIN_STOP_PUSH', 'GBRAIN_SUPERVIS', 'GBRAIN_SWEEP', 'GBRAIN_SYNC', 'GBRAIN_WORKER_',
];
const NOT_READ_BEHAVIOR = new Set([
- 'GBRAIN_AGENT_INSTRUCTIONS', 'GBRAIN_SKILL_LOADING', 'GBRAIN_PLUGIN', 'GBRAIN_HOME', 'GBRAIN_SERVE_LOG_MAX_BYTES', 'GBRAIN_SERVE_LOG_MAX_FILES', 'GBRAIN_SERVE_LOG_DEDUPE_SECONDS', 'GBRAIN_BRAIN_ID', 'GBRAIN_MOUNTS_PATH', 'GBRAIN_CWD_ENV_QUARANTINED',
+ 'GBRAIN_AGENT_INSTRUCTIONS', 'GBRAIN_BUILD_COMMIT', 'GBRAIN_SKILL_LOADING', 'GBRAIN_PLUGIN', 'GBRAIN_HOME', 'GBRAIN_SERVE_LOG_MAX_BYTES', 'GBRAIN_SERVE_LOG_MAX_FILES', 'GBRAIN_SERVE_LOG_DEDUPE_SECONDS', 'GBRAIN_BRAIN_ID', 'GBRAIN_MOUNTS_PATH', 'GBRAIN_CWD_ENV_QUARANTINED',
'GBRAIN_FAIL_ON_EMPTY', 'GBRAIN_SESSION_AGENT', 'GBRAIN_CLI_SOCKET', 'GBRAIN_DEBUG', 'GBRAIN_SQL_TRACE', 'GBRAIN_SQL_TRACE_LABEL', 'GBRAIN_MEMORY_TRACE', 'GBRAIN_LME_DEBUG', 'GBRAIN_SOURCE',
'GBRAIN_DATABASE_URL', 'GBRAIN_DIRECT_DATABASE_URL', 'GBRAIN_DIRECT_POOL_SIZE', 'GBRAIN_DIRECT_POOL_BY_COMMAND', 'GBRAIN_DISABLE_DIRECT_POOL', 'GBRAIN_PREPARE',
'GBRAIN_IDLE_TX_TIMEOUT', 'GBRAIN_MAX_CONNECTIONS', 'GBRAIN_NO_RETRY_CONNECT', 'GBRAIN_DB_ACCESS',
diff --git a/test/fixtures/goldens/exports/runtime.json b/test/fixtures/goldens/exports/runtime.json
index 05f3dee335..3b0c7ec13e 100644
--- a/test/fixtures/goldens/exports/runtime.json
+++ b/test/fixtures/goldens/exports/runtime.json
@@ -997,16 +997,22 @@
],
"./skill-resolver": [
"BLOCK_TOKEN_CAP",
+ "EXCLUDE_MAX",
"GBRAIN_VERSION",
"HARNESSES",
+ "MATCH_STRENGTHS",
+ "RESOLVER_FEATURES",
"ResolverError",
"SCHEMA_VERSION",
"buildSkillIndex",
+ "buildSkillIndexOffThread",
"catalogStatus",
"commitSessionAsync",
"errorTurnOutput",
+ "gcSkillSessions",
"listCatalogs",
"normalizeTurnInput",
+ "openCatalog",
"removeSkillIndex",
"resetSkillSession",
"resolveSkills",
diff --git a/test/fixtures/goldens/exports/types.json b/test/fixtures/goldens/exports/types.json
index 5216e93a68..37f70a1f32 100644
--- a/test/fixtures/goldens/exports/types.json
+++ b/test/fixtures/goldens/exports/types.json
@@ -8717,6 +8717,7 @@
"members": [
"bundled?: boolean | undefined",
"catalog: string",
+ "claudePlugins?: string | undefined",
"dirs?: string[] | undefined",
"fromJson?: string | undefined",
"fromJsonStdin?: boolean | undefined",
@@ -8731,7 +8732,7 @@
"members": [
"block: { token_cap: number; tokenizer: string; }",
"build: { args: string[]; rebuild_argv: string[] | null; ms: number; built_at: string; generation: number; }",
- "catalog: { name: string; catalog_hash: string; source: { kind: \"dir\" | \"bundled\" | \"json\"; dirs?: string[]; stdin?: boolean; file?: string; snapshot?: \"source.json\"; bundled_skills?: number; }; fingerprint_sha256: string | null; skill_count: number; skipped: SkippedSkill[]; scope: \"user\" | \"project\"; hints: \"shown\" | \"names_only\"; harness: string | null; routing: { file: string; rows: number; unmatched: number; stat: [string, number, number]; } | null; }",
+ "catalog: { name: string; catalog_hash: string; source: { kind: \"dir\" | \"bundled\" | \"json\" | \"claude_plugins\"; dirs?: string[]; stdin?: boolean; file?: string; snapshot?: \"source.json\"; bundled_skills?: number; claude_dir?: string; }; fingerprint_sha256: string | null; skill_count: number; skipped: SkippedSkill[]; scope: \"user\" | \"project\"; hints: \"shown\" | \"names_only\"; harness: string | null; routing: { file: string; rows: number; unmatched: number; stat: [string, number, number]; } | null; }",
"gbrain_commit: string | null",
"gbrain_version: string",
"index: { file: \"index.bin\"; index_hash: string; size: number; n_terms: number; n_postings: number; truncated_skills: number; }",
@@ -8740,6 +8741,21 @@
],
"name": "BuildReceipt"
},
+ {
+ "kind": "interface",
+ "members": [
+ "close: () => void",
+ "resolve: (input: TurnInput | unknown, turn?: CatalogTurnOptions) => Promise<ResolveResult>"
+ ],
+ "name": "CatalogHandle"
+ },
+ {
+ "kind": "type",
+ "name": "CatalogHandleOptions",
+ "signature": [
+ "{ home?: string | undefined; failOpen?: boolean | undefined; deadlineMs?: number | undefined; sessionTokenBudget?: number | undefined; loadHint?: string | undefined; namesOnly?: boolean | undefined; explainTarget?: string | undefined; env?: NodeJS.ProcessEnv | undefined; now?: (() => number) | undefined; }"
+ ]
+ },
{
"kind": "interface",
"members": [
@@ -8753,6 +8769,20 @@
],
"name": "CatalogStatus"
},
+ {
+ "kind": "type",
+ "name": "CatalogTurnOptions",
+ "signature": [
+ "{ failOpen?: boolean | undefined; deadlineMs?: number | undefined; sessionTokenBudget?: number | undefined; loadHint?: string | undefined; namesOnly?: boolean | undefined; explainTarget?: string | undefined; now?: (() => number) | undefined; }"
+ ]
+ },
+ {
+ "kind": "variable",
+ "name": "EXCLUDE_MAX",
+ "signature": [
+ "1024"
+ ]
+ },
{
"kind": "interface",
"members": [
@@ -8781,7 +8811,14 @@
"kind": "variable",
"name": "HARNESSES",
"signature": [
- "readonly [\"openclaw\", \"claude-code\", \"codex\", \"hermes\", \"qm\"]"
+ "readonly [\"openclaw\", \"claude-code\", \"codex\", \"hermes\", \"qm\", \"pi\", \"cursor\"]"
+ ]
+ },
+ {
+ "kind": "variable",
+ "name": "MATCH_STRENGTHS",
+ "signature": [
+ "readonly MatchStrength[]"
]
},
{
@@ -8791,6 +8828,13 @@
"\"body\" | \"name\" | \"description\" | \"named\" | \"triggers\" | \"routing\""
]
},
+ {
+ "kind": "variable",
+ "name": "RESOLVER_FEATURES",
+ "signature": [
+ "readonly string[]"
+ ]
+ },
{
"kind": "interface",
"members": [
@@ -8888,6 +8932,7 @@
"expected_catalog_hash?: string | undefined",
"harness?: string | undefined",
"message: string",
+ "min_match_strength?: MatchStrength | undefined",
"previous_user_message?: string | undefined",
"reset_session?: boolean | undefined",
"session_id?: string | undefined",
@@ -8900,6 +8945,7 @@
"kind": "interface",
"members": [
"block: string",
+ "block_reason: BlockReason | null",
"block_tokens: number",
"budget_exhausted: boolean",
"catalog: string | null",
@@ -8926,6 +8972,13 @@
"(input: BuildInput, opts?: { home?: string; now?: () => number; }) => Promise<BuildReceipt>"
]
},
+ {
+ "kind": "function",
+ "name": "buildSkillIndexOffThread",
+ "signature": [
+ "(input: BuildInput, opts?: { home?: string; }) => Promise<BuildReceipt>"
+ ]
+ },
{
"kind": "function",
"name": "catalogStatus",
@@ -8937,7 +8990,7 @@
"kind": "function",
"name": "commitSessionAsync",
"signature": [
- "(home: string, key: string, delta: TurnDelta) => Promise<boolean>"
+ "(home: string, key: string, delta: TurnDelta, hold?: CommitHold) => Promise<boolean>"
]
},
{
@@ -8947,6 +9000,13 @@
"(err: ResolverError, opts?: { shadow?: boolean; catalog?: string | null; }) => TurnOutput"
]
},
+ {
+ "kind": "function",
+ "name": "gcSkillSessions",
+ "signature": [
+ "(opts?: { home?: string; now?: number; }) => Promise<number>"
+ ]
+ },
{
"kind": "function",
"name": "listCatalogs",
@@ -8961,6 +9021,13 @@
"(raw: unknown) => Required<Pick<TurnInput, \"message\" | \"top_k\" | \"exclude\" | \"shadow\" | \"reset_session\">> & TurnInput"
]
},
+ {
+ "kind": "function",
+ "name": "openCatalog",
+ "signature": [
+ "(catalogs: string[], opts?: CatalogHandleOptions) => CatalogHandle"
+ ]
+ },
{
"kind": "function",
"name": "removeSkillIndex",