@lucern/sdk 0.2.0-alpha.13 → 0.2.0-alpha.3

package/dist/sdkSurface.js

@@ -1,112 +0,0 @@
-// src/sdkSurface.ts
-function asRecord(value) {
-  return value && typeof value === "object" ? value : {};
-}
-function cleanString(value) {
-  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
-}
-function normalizeVerificationStatus(value) {
-  const status = cleanString(value);
-  if (!status) {
-    return void 0;
-  }
-  if (status === "verified") {
-    return "human_verified";
-  }
-  if (status === "rejected") {
-    return "contradicted";
-  }
-  return status;
-}
-function cloneWith(value, patch) {
-  return { ...value, ...patch };
-}
-function resolveTopicId(value) {
-  return cleanString(value.topicId);
-}
-function resolveText(value) {
-  return cleanString(value.text) ?? cleanString(value.canonicalText);
-}
-function withTopicAlias(value) {
-  const topicId = cleanString(value.topicId) ?? void 0;
-  if (!topicId) {
-    return value;
-  }
-  return cloneWith(value, { topicId });
-}
-function withTextAlias(value) {
-  const text = cleanString(value.text) ?? cleanString(value.canonicalText) ?? void 0;
-  if (!text) {
-    return value;
-  }
-  return cloneWith(value, { text, canonicalText: text });
-}
-function withSdkAliases(value) {
-  return withTopicAlias(withTextAlias(value));
-}
-function normalizeNodeWriteInput(value) {
-  const topicId = resolveTopicId(value);
-  const text = resolveText(value);
-  const verificationStatus = normalizeVerificationStatus(value.verificationStatus);
-  const next = { ...value };
-  if (topicId) {
-    next.topicId = topicId;
-  }
-  if (text) {
-    next.text = text;
-    next.canonicalText = text;
-  }
-  if (verificationStatus) {
-    next.verificationStatus = verificationStatus;
-  }
-  return next;
-}
-function normalizeNodeVerificationStatus(value) {
-  return normalizeVerificationStatus(value);
-}
-function normalizeTopicQuery(value) {
-  const topicId = cleanString(value.topicId);
-  if (!topicId) {
-    return value;
-  }
-  return { ...value, topicId };
-}
-function asListItems(data, legacyKey) {
-  if (Array.isArray(data)) {
-    return data;
-  }
-  const record = asRecord(data);
-  if (Array.isArray(record.items)) {
-    return record.items;
-  }
-  if (legacyKey && Array.isArray(record[legacyKey])) {
-    return record[legacyKey];
-  }
-  return [];
-}
-function createListResult(items, legacyKey) {
-  const result = {
-    items,
-    total: items.length
-  };
-  if (legacyKey) {
-    result[legacyKey] = items;
-  }
-  return result;
-}
-function mapGatewayData(response, mapper) {
-  return {
-    ...response,
-    data: mapper(response.data)
-  };
-}
-function mapAliasedList(data, legacyKey) {
-  const items = asListItems(data, legacyKey).map(
-    (item) => withSdkAliases(item)
-  );
-  return createListResult(items, legacyKey);
-}
-
-export { asListItems, createListResult, mapAliasedList, mapGatewayData, normalizeNodeVerificationStatus, normalizeNodeWriteInput, normalizeTopicQuery, resolveText, resolveTopicId, withSdkAliases, withTextAlias, withTopicAlias };
-//# sourceMappingURL=sdkSurface.js.map
-//# sourceMappingURL=sdkSurface.js.map

package/dist/sdkSurface.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/sdkSurface.ts"],"names":[],"mappings":"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","file":"sdkSurface.js","sourcesContent":["import type { PlatformGatewaySuccess } from \"./coreClient\";\nimport type { JsonObject, ListResult } from \"./types\";\n\ntype TopicScopedValue = {\n  topicId?: string;\n};\n\ntype TextScopedValue = {\n  text?: string;\n  canonicalText?: string;\n};\n\ntype AnyRecord = Record<string, unknown>;\n\nfunction asRecord(value: unknown): AnyRecord {\n  return value && typeof value === \"object\" ? (value as AnyRecord) : {};\n}\n\nfunction cleanString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0\n    ? value.trim()\n    : undefined;\n}\n\nfunction normalizeVerificationStatus(value: unknown): string | undefined {\n  const status = cleanString(value);\n  if (!status) {\n    return undefined;\n  }\n  if (status === \"verified\") {\n    return \"human_verified\";\n  }\n  if (status === \"rejected\") {\n    return \"contradicted\";\n  }\n  return status;\n}\n\nfunction cloneWith<T extends AnyRecord>(value: T, patch: AnyRecord): T {\n  return { ...value, ...patch } as T;\n}\n\n/**\n * Resolve the canonical topic identifier.\n */\nexport function resolveTopicId(value: TopicScopedValue): string | undefined {\n  return cleanString(value.topicId);\n}\n\n/**\n * Resolve the canonical text field from text-first or legacy canonicalText-first inputs.\n */\nexport function resolveText(value: TextScopedValue): string | undefined {\n  return cleanString(value.text) ?? cleanString(value.canonicalText);\n}\n\n/**\n * Attach the topicId to a record.\n */\nexport function withTopicAlias<T extends AnyRecord>(value: T): T {\n  const topicId = cleanString(value.topicId) ?? undefined;\n  if (!topicId) {\n    return value;\n  }\n  return cloneWith(value, { topicId });\n}\n\n/**\n * Attach the text/canonicalText alias pair to a record.\n */\nexport function withTextAlias<T extends AnyRecord>(value: T): T {\n  const text =\n    cleanString(value.text) ?? cleanString(value.canonicalText) ?? undefined;\n  if (!text) {\n    return value;\n  }\n  return cloneWith(value, { text, canonicalText: text });\n}\n\n/**\n * Attach topic and text aliases to SDK node-like records.\n */\nexport function withSdkAliases<T extends AnyRecord>(value: T): T {\n  return withTopicAlias(withTextAlias(value));\n}\n\n/**\n * Normalize a belief/question/evidence write payload to the canonical gateway shape.\n */\nexport function normalizeNodeWriteInput<T extends JsonObject>(value: T): T {\n  const topicId = resolveTopicId(value);\n  const text = resolveText(value);\n  const verificationStatus = normalizeVerificationStatus(value.verificationStatus);\n  const next = { ...value } as JsonObject;\n\n  if (topicId) {\n    next.topicId = topicId;\n  }\n  if (text) {\n    next.text = text;\n    next.canonicalText = text;\n  }\n  if (verificationStatus) {\n    next.verificationStatus = verificationStatus;\n  }\n\n  return next as T;\n}\n\nexport function normalizeNodeVerificationStatus(value: unknown) {\n  return normalizeVerificationStatus(value);\n}\n\n/**\n * Build a topic-aware query object.\n */\nexport function normalizeTopicQuery<T extends JsonObject>(value: T): T {\n  const topicId = cleanString(value.topicId);\n  if (!topicId) {\n    return value;\n  }\n  return { ...value, topicId } as T;\n}\n\n/**\n * Extract list items from array or list-envelope payloads.\n */\nexport function asListItems<T>(data: unknown, legacyKey?: string): T[] {\n  if (Array.isArray(data)) {\n    return data as T[];\n  }\n\n  const record = asRecord(data);\n  if (Array.isArray(record.items)) {\n    return record.items as T[];\n  }\n  if (legacyKey && Array.isArray(record[legacyKey])) {\n    return record[legacyKey] as T[];\n  }\n\n  return [];\n}\n\n/**\n * Standardize list data to { items, total } while retaining an optional legacy array key.\n */\nexport function createListResult<T, LegacyKey extends string>(\n  items: T[],\n  legacyKey?: LegacyKey\n): ListResult<T, LegacyKey> {\n  const result = {\n    items,\n    total: items.length,\n  } as ListResult<T, LegacyKey>;\n\n  if (legacyKey) {\n    (result as Record<string, unknown>)[legacyKey] = items;\n  }\n\n  return result;\n}\n\n/**\n * Map a gateway success envelope's data while preserving the transport metadata.\n */\nexport function mapGatewayData<T, U>(\n  response: PlatformGatewaySuccess<T>,\n  mapper: (data: T) => U\n): PlatformGatewaySuccess<U> {\n  return {\n    ...response,\n    data: mapper(response.data),\n  };\n}\n\n/**\n * Apply SDK aliases across all items in a list-like payload.\n */\nexport function mapAliasedList<\n  TItem extends AnyRecord,\n  LegacyKey extends string,\n>(\n  data: unknown,\n  legacyKey?: LegacyKey\n): ListResult<TItem, LegacyKey> {\n  const items = asListItems<TItem>(data, legacyKey).map((item) =>\n    withSdkAliases(item)\n  );\n  return createListResult(items, legacyKey);\n}\n"]}

package/dist/sdkTools-CwXJDACb.d.ts

@@ -1,150 +0,0 @@
-import { M as McpToolContract } from './mcpTools-DPZxowDX.js';
-
-/**
- * SDK-Only Tool Contract Definitions
- *
- * Tools available in @lucern/sdk but NOT in the MCP gateway.
- * The SDK unfolds deeper capabilities after the MCP gateway shows developers what's possible.
- *
- * Total SDK surface = MCP tools (44) + SDK-only tools (44) = 88 tools
- *
- * These tools are organized into capability tiers:
- * - Advanced workflow & phase management (12 tools)
- * - Deeper graph navigation (6 tools)
- * - Conviction & analytics (7 tools)
- * - Extended question & evidence analytics (1 tool; core lifecycle promoted to MCP)
- * - Task lifecycle (5 tools)
- * - Domain analytics (8 tools)
- * - Bias detection suite (5 tools)
- *
- * CONTRACT SURFACE: These definitions are the external API for SDK consumers.
- * Renaming a tool or changing its description is a BREAKING CHANGE.
- *
- * Git-native naming rules (same as MCP, enforced by lint):
- *   1. Workflow tools use git verbs directly
- *   2. Knowledge tools use epistemic verbs
- *   3. First sentence of description includes the git analog verb
- *   4. Description includes "Like `git X`" parenthetical
- *   5. Parameter names use domain terms (canonicalText, nodeId, confidence)
- */
-
-/** SDK-only tool contract — same shape as MCP but with sdk-only tier marker */
-interface SdkToolContract extends Omit<McpToolContract, "tier"> {
-    tier: "sdk-only";
-}
-declare const START_WORKTREE: SdkToolContract;
-declare const UPDATE_WORKTREE_PHASE: SdkToolContract;
-declare const ADVANCE_WORKTREE_PHASE: SdkToolContract;
-declare const ADD_NOTE_TO_WORKTREE: SdkToolContract;
-declare const LINK_DOCUMENT_TO_WORKTREE: SdkToolContract;
-declare const LINK_EVIDENCE_TO_WORKTREE: SdkToolContract;
-declare const LINK_QUESTION_TO_WORKTREE: SdkToolContract;
-declare const LINK_BELIEF_TO_WORKTREE: SdkToolContract;
-declare const CREATE_SYNTHESIZED_BELIEF: SdkToolContract;
-declare const COMPLETE_HYPOTHESIS_FORMATION: SdkToolContract;
-declare const COMPLETE_EVIDENCE_REVIEW: SdkToolContract;
-declare const REFINE_WORKTREE_BELIEF: SdkToolContract;
-declare const TRACE_PROVENANCE: SdkToolContract;
-declare const GET_BELIEF_RELATIONSHIPS: SdkToolContract;
-declare const GET_BELIEF_SUPPORT_CHAIN: SdkToolContract;
-declare const EXPLORE_CONNECTIONS: SdkToolContract;
-declare const GET_DEEP_LINEAGE: SdkToolContract;
-declare const GRAPH_AWARE_SEARCH: SdkToolContract;
-declare const GET_COLLECTION_CONVICTION: SdkToolContract;
-declare const GET_CONVICTION_TREND: SdkToolContract;
-declare const ANALYZE_BELIEF_CRITICALITY: SdkToolContract;
-declare const ANALYZE_BELIEF_CLUSTER_CANDIDATES: SdkToolContract;
-declare const CREATE_BELIEF_CONDITIONAL: SdkToolContract;
-declare const GET_NECESSARY_EVIDENCE: SdkToolContract;
-declare const ANALYZE_REASONING_DEPTH: SdkToolContract;
-declare const GET_EVIDENCE_BY_METHODOLOGY: SdkToolContract;
-declare const CREATE_EVIDENCE_TASK: SdkToolContract;
-declare const LIST_TASKS: SdkToolContract;
-declare const UPDATE_TASK: SdkToolContract;
-declare const GET_TASK_COUNTS: SdkToolContract;
-declare const ADD_RESEARCH_ACTION: SdkToolContract;
-declare const GET_PREDICTIONS: SdkToolContract;
-declare const GET_SURPRISE_DETECTION: SdkToolContract;
-declare const GET_CHALLENGED_BELIEFS: SdkToolContract;
-declare const GET_CAUSAL_CHAINS: SdkToolContract;
-declare const GET_NON_CONSENSUS_BELIEFS: SdkToolContract;
-declare const GET_BELIEFS_BY_EPISTEMIC_STATUS: SdkToolContract;
-declare const GET_PRIVILEGED_EVIDENCE: SdkToolContract;
-declare const GET_PRIVILEGED_SIGNALS: SdkToolContract;
-declare const DETECT_ANCHORING_BIAS: SdkToolContract;
-declare const DETECT_SOURCE_CONCENTRATION: SdkToolContract;
-declare const FIND_SOFT_CONTRADICTIONS: SdkToolContract;
-declare const FIND_SEMANTIC_BRIDGES: SdkToolContract;
-declare const FIND_SEMANTIC_ORPHANS: SdkToolContract;
-/** All SDK-only tool contracts, indexed by name */
-declare const SDK_ONLY_TOOL_CONTRACTS: Record<string, SdkToolContract>;
-/** Complete SDK surface: MCP gateway tools + SDK-only advanced tools */
-declare const ALL_SDK_TOOL_CONTRACTS: Record<string, McpToolContract | SdkToolContract>;
-/** All SDK-only tool names */
-declare const SDK_ONLY_TOOL_NAMES: string[];
-/** All tool names across the complete SDK surface */
-declare const ALL_SDK_TOOL_NAMES: string[];
-/**
- * Lint validation: every SDK tool description must contain "Like `git" reference.
- * Reuses the same git-semantic validation rule as MCP tools.
- */
-declare function validateSdkGitSemantics(tool: SdkToolContract): {
-    valid: boolean;
-    reason?: string;
-};
-
-declare const sdkTools_contract_ADD_NOTE_TO_WORKTREE: typeof ADD_NOTE_TO_WORKTREE;
-declare const sdkTools_contract_ADD_RESEARCH_ACTION: typeof ADD_RESEARCH_ACTION;
-declare const sdkTools_contract_ADVANCE_WORKTREE_PHASE: typeof ADVANCE_WORKTREE_PHASE;
-declare const sdkTools_contract_ALL_SDK_TOOL_CONTRACTS: typeof ALL_SDK_TOOL_CONTRACTS;
-declare const sdkTools_contract_ALL_SDK_TOOL_NAMES: typeof ALL_SDK_TOOL_NAMES;
-declare const sdkTools_contract_ANALYZE_BELIEF_CLUSTER_CANDIDATES: typeof ANALYZE_BELIEF_CLUSTER_CANDIDATES;
-declare const sdkTools_contract_ANALYZE_BELIEF_CRITICALITY: typeof ANALYZE_BELIEF_CRITICALITY;
-declare const sdkTools_contract_ANALYZE_REASONING_DEPTH: typeof ANALYZE_REASONING_DEPTH;
-declare const sdkTools_contract_COMPLETE_EVIDENCE_REVIEW: typeof COMPLETE_EVIDENCE_REVIEW;
-declare const sdkTools_contract_COMPLETE_HYPOTHESIS_FORMATION: typeof COMPLETE_HYPOTHESIS_FORMATION;
-declare const sdkTools_contract_CREATE_BELIEF_CONDITIONAL: typeof CREATE_BELIEF_CONDITIONAL;
-declare const sdkTools_contract_CREATE_EVIDENCE_TASK: typeof CREATE_EVIDENCE_TASK;
-declare const sdkTools_contract_CREATE_SYNTHESIZED_BELIEF: typeof CREATE_SYNTHESIZED_BELIEF;
-declare const sdkTools_contract_DETECT_ANCHORING_BIAS: typeof DETECT_ANCHORING_BIAS;
-declare const sdkTools_contract_DETECT_SOURCE_CONCENTRATION: typeof DETECT_SOURCE_CONCENTRATION;
-declare const sdkTools_contract_EXPLORE_CONNECTIONS: typeof EXPLORE_CONNECTIONS;
-declare const sdkTools_contract_FIND_SEMANTIC_BRIDGES: typeof FIND_SEMANTIC_BRIDGES;
-declare const sdkTools_contract_FIND_SEMANTIC_ORPHANS: typeof FIND_SEMANTIC_ORPHANS;
-declare const sdkTools_contract_FIND_SOFT_CONTRADICTIONS: typeof FIND_SOFT_CONTRADICTIONS;
-declare const sdkTools_contract_GET_BELIEFS_BY_EPISTEMIC_STATUS: typeof GET_BELIEFS_BY_EPISTEMIC_STATUS;
-declare const sdkTools_contract_GET_BELIEF_RELATIONSHIPS: typeof GET_BELIEF_RELATIONSHIPS;
-declare const sdkTools_contract_GET_BELIEF_SUPPORT_CHAIN: typeof GET_BELIEF_SUPPORT_CHAIN;
-declare const sdkTools_contract_GET_CAUSAL_CHAINS: typeof GET_CAUSAL_CHAINS;
-declare const sdkTools_contract_GET_CHALLENGED_BELIEFS: typeof GET_CHALLENGED_BELIEFS;
-declare const sdkTools_contract_GET_COLLECTION_CONVICTION: typeof GET_COLLECTION_CONVICTION;
-declare const sdkTools_contract_GET_CONVICTION_TREND: typeof GET_CONVICTION_TREND;
-declare const sdkTools_contract_GET_DEEP_LINEAGE: typeof GET_DEEP_LINEAGE;
-declare const sdkTools_contract_GET_EVIDENCE_BY_METHODOLOGY: typeof GET_EVIDENCE_BY_METHODOLOGY;
-declare const sdkTools_contract_GET_NECESSARY_EVIDENCE: typeof GET_NECESSARY_EVIDENCE;
-declare const sdkTools_contract_GET_NON_CONSENSUS_BELIEFS: typeof GET_NON_CONSENSUS_BELIEFS;
-declare const sdkTools_contract_GET_PREDICTIONS: typeof GET_PREDICTIONS;
-declare const sdkTools_contract_GET_PRIVILEGED_EVIDENCE: typeof GET_PRIVILEGED_EVIDENCE;
-declare const sdkTools_contract_GET_PRIVILEGED_SIGNALS: typeof GET_PRIVILEGED_SIGNALS;
-declare const sdkTools_contract_GET_SURPRISE_DETECTION: typeof GET_SURPRISE_DETECTION;
-declare const sdkTools_contract_GET_TASK_COUNTS: typeof GET_TASK_COUNTS;
-declare const sdkTools_contract_GRAPH_AWARE_SEARCH: typeof GRAPH_AWARE_SEARCH;
-declare const sdkTools_contract_LINK_BELIEF_TO_WORKTREE: typeof LINK_BELIEF_TO_WORKTREE;
-declare const sdkTools_contract_LINK_DOCUMENT_TO_WORKTREE: typeof LINK_DOCUMENT_TO_WORKTREE;
-declare const sdkTools_contract_LINK_EVIDENCE_TO_WORKTREE: typeof LINK_EVIDENCE_TO_WORKTREE;
-declare const sdkTools_contract_LINK_QUESTION_TO_WORKTREE: typeof LINK_QUESTION_TO_WORKTREE;
-declare const sdkTools_contract_LIST_TASKS: typeof LIST_TASKS;
-declare const sdkTools_contract_REFINE_WORKTREE_BELIEF: typeof REFINE_WORKTREE_BELIEF;
-declare const sdkTools_contract_SDK_ONLY_TOOL_CONTRACTS: typeof SDK_ONLY_TOOL_CONTRACTS;
-declare const sdkTools_contract_SDK_ONLY_TOOL_NAMES: typeof SDK_ONLY_TOOL_NAMES;
-declare const sdkTools_contract_START_WORKTREE: typeof START_WORKTREE;
-type sdkTools_contract_SdkToolContract = SdkToolContract;
-declare const sdkTools_contract_TRACE_PROVENANCE: typeof TRACE_PROVENANCE;
-declare const sdkTools_contract_UPDATE_TASK: typeof UPDATE_TASK;
-declare const sdkTools_contract_UPDATE_WORKTREE_PHASE: typeof UPDATE_WORKTREE_PHASE;
-declare const sdkTools_contract_validateSdkGitSemantics: typeof validateSdkGitSemantics;
-declare namespace sdkTools_contract {
-  export { sdkTools_contract_ADD_NOTE_TO_WORKTREE as ADD_NOTE_TO_WORKTREE, sdkTools_contract_ADD_RESEARCH_ACTION as ADD_RESEARCH_ACTION, sdkTools_contract_ADVANCE_WORKTREE_PHASE as ADVANCE_WORKTREE_PHASE, sdkTools_contract_ALL_SDK_TOOL_CONTRACTS as ALL_SDK_TOOL_CONTRACTS, sdkTools_contract_ALL_SDK_TOOL_NAMES as ALL_SDK_TOOL_NAMES, sdkTools_contract_ANALYZE_BELIEF_CLUSTER_CANDIDATES as ANALYZE_BELIEF_CLUSTER_CANDIDATES, sdkTools_contract_ANALYZE_BELIEF_CRITICALITY as ANALYZE_BELIEF_CRITICALITY, sdkTools_contract_ANALYZE_REASONING_DEPTH as ANALYZE_REASONING_DEPTH, sdkTools_contract_COMPLETE_EVIDENCE_REVIEW as COMPLETE_EVIDENCE_REVIEW, sdkTools_contract_COMPLETE_HYPOTHESIS_FORMATION as COMPLETE_HYPOTHESIS_FORMATION, sdkTools_contract_CREATE_BELIEF_CONDITIONAL as CREATE_BELIEF_CONDITIONAL, sdkTools_contract_CREATE_EVIDENCE_TASK as CREATE_EVIDENCE_TASK, sdkTools_contract_CREATE_SYNTHESIZED_BELIEF as CREATE_SYNTHESIZED_BELIEF, sdkTools_contract_DETECT_ANCHORING_BIAS as DETECT_ANCHORING_BIAS, sdkTools_contract_DETECT_SOURCE_CONCENTRATION as DETECT_SOURCE_CONCENTRATION, sdkTools_contract_EXPLORE_CONNECTIONS as EXPLORE_CONNECTIONS, sdkTools_contract_FIND_SEMANTIC_BRIDGES as FIND_SEMANTIC_BRIDGES, sdkTools_contract_FIND_SEMANTIC_ORPHANS as FIND_SEMANTIC_ORPHANS, sdkTools_contract_FIND_SOFT_CONTRADICTIONS as FIND_SOFT_CONTRADICTIONS, sdkTools_contract_GET_BELIEFS_BY_EPISTEMIC_STATUS as GET_BELIEFS_BY_EPISTEMIC_STATUS, sdkTools_contract_GET_BELIEF_RELATIONSHIPS as GET_BELIEF_RELATIONSHIPS, sdkTools_contract_GET_BELIEF_SUPPORT_CHAIN as GET_BELIEF_SUPPORT_CHAIN, sdkTools_contract_GET_CAUSAL_CHAINS as GET_CAUSAL_CHAINS, sdkTools_contract_GET_CHALLENGED_BELIEFS as GET_CHALLENGED_BELIEFS, sdkTools_contract_GET_COLLECTION_CONVICTION as GET_COLLECTION_CONVICTION, sdkTools_contract_GET_CONVICTION_TREND as GET_CONVICTION_TREND, sdkTools_contract_GET_DEEP_LINEAGE as GET_DEEP_LINEAGE, sdkTools_contract_GET_EVIDENCE_BY_METHODOLOGY as GET_EVIDENCE_BY_METHODOLOGY, sdkTools_contract_GET_NECESSARY_EVIDENCE as GET_NECESSARY_EVIDENCE, sdkTools_contract_GET_NON_CONSENSUS_BELIEFS as GET_NON_CONSENSUS_BELIEFS, sdkTools_contract_GET_PREDICTIONS as GET_PREDICTIONS, sdkTools_contract_GET_PRIVILEGED_EVIDENCE as GET_PRIVILEGED_EVIDENCE, sdkTools_contract_GET_PRIVILEGED_SIGNALS as GET_PRIVILEGED_SIGNALS, sdkTools_contract_GET_SURPRISE_DETECTION as GET_SURPRISE_DETECTION, sdkTools_contract_GET_TASK_COUNTS as GET_TASK_COUNTS, sdkTools_contract_GRAPH_AWARE_SEARCH as GRAPH_AWARE_SEARCH, sdkTools_contract_LINK_BELIEF_TO_WORKTREE as LINK_BELIEF_TO_WORKTREE, sdkTools_contract_LINK_DOCUMENT_TO_WORKTREE as LINK_DOCUMENT_TO_WORKTREE, sdkTools_contract_LINK_EVIDENCE_TO_WORKTREE as LINK_EVIDENCE_TO_WORKTREE, sdkTools_contract_LINK_QUESTION_TO_WORKTREE as LINK_QUESTION_TO_WORKTREE, sdkTools_contract_LIST_TASKS as LIST_TASKS, sdkTools_contract_REFINE_WORKTREE_BELIEF as REFINE_WORKTREE_BELIEF, sdkTools_contract_SDK_ONLY_TOOL_CONTRACTS as SDK_ONLY_TOOL_CONTRACTS, sdkTools_contract_SDK_ONLY_TOOL_NAMES as SDK_ONLY_TOOL_NAMES, sdkTools_contract_START_WORKTREE as START_WORKTREE, type sdkTools_contract_SdkToolContract as SdkToolContract, sdkTools_contract_TRACE_PROVENANCE as TRACE_PROVENANCE, sdkTools_contract_UPDATE_TASK as UPDATE_TASK, sdkTools_contract_UPDATE_WORKTREE_PHASE as UPDATE_WORKTREE_PHASE, sdkTools_contract_validateSdkGitSemantics as validateSdkGitSemantics };
-}
-
-export { ADVANCE_WORKTREE_PHASE as A, GET_CHALLENGED_BELIEFS as B, CREATE_SYNTHESIZED_BELIEF as C, GET_CAUSAL_CHAINS as D, EXPLORE_CONNECTIONS as E, GET_NON_CONSENSUS_BELIEFS as F, GET_BELIEF_RELATIONSHIPS as G, GET_BELIEFS_BY_EPISTEMIC_STATUS as H, GET_PRIVILEGED_EVIDENCE as I, GET_PRIVILEGED_SIGNALS as J, DETECT_ANCHORING_BIAS as K, LINK_DOCUMENT_TO_WORKTREE as L, DETECT_SOURCE_CONCENTRATION as M, FIND_SOFT_CONTRADICTIONS as N, FIND_SEMANTIC_BRIDGES as O, FIND_SEMANTIC_ORPHANS as P, SDK_ONLY_TOOL_CONTRACTS as Q, REFINE_WORKTREE_BELIEF as R, type SdkToolContract as S, TRACE_PROVENANCE as T, UPDATE_WORKTREE_PHASE as U, ALL_SDK_TOOL_CONTRACTS as V, SDK_ONLY_TOOL_NAMES as W, ALL_SDK_TOOL_NAMES as X, validateSdkGitSemantics as Y, START_WORKTREE as a, ADD_NOTE_TO_WORKTREE as b, LINK_EVIDENCE_TO_WORKTREE as c, LINK_QUESTION_TO_WORKTREE as d, LINK_BELIEF_TO_WORKTREE as e, COMPLETE_HYPOTHESIS_FORMATION as f, COMPLETE_EVIDENCE_REVIEW as g, GET_BELIEF_SUPPORT_CHAIN as h, GET_DEEP_LINEAGE as i, GRAPH_AWARE_SEARCH as j, GET_COLLECTION_CONVICTION as k, GET_CONVICTION_TREND as l, ANALYZE_BELIEF_CRITICALITY as m, ANALYZE_BELIEF_CLUSTER_CANDIDATES as n, CREATE_BELIEF_CONDITIONAL as o, GET_NECESSARY_EVIDENCE as p, ANALYZE_REASONING_DEPTH as q, GET_EVIDENCE_BY_METHODOLOGY as r, sdkTools_contract as s, CREATE_EVIDENCE_TASK as t, LIST_TASKS as u, UPDATE_TASK as v, GET_TASK_COUNTS as w, ADD_RESEARCH_ACTION as x, GET_PREDICTIONS as y, GET_SURPRISE_DETECTION as z };

package/dist/sourcesClient.d.ts

@@ -1,24 +0,0 @@
-import { GatewayClientConfig, PlatformGatewaySuccess } from './coreClient.js';
-export { LucernApiError } from './coreClient.js';
-import { JsonObject, PlatformSourceRecord } from './types.js';
-export { GetSourceResponse, UpsertSourceResponse } from './types.js';
-import './contracts/workflow-runtime.contract.js';
-import './contracts/lens-workflow.contract.js';
-import './contracts/lens-filter.contract.js';
-
-type SourcesClientConfig = GatewayClientConfig;
-type UpsertSourceSpec = {
-    url?: string;
-    sha?: string;
-    kind: string;
-    title?: string;
-    capturedAt?: number;
-    topicId?: string;
-    metadata?: JsonObject;
-};
-declare function createSourcesClient(config?: SourcesClientConfig): {
-    upsert(spec: UpsertSourceSpec, idempotencyKey?: string): Promise<PlatformGatewaySuccess<PlatformSourceRecord>>;
-    get(sourceId: string): Promise<PlatformGatewaySuccess<PlatformSourceRecord>>;
-};
-
-export { PlatformGatewaySuccess, type SourcesClientConfig, type UpsertSourceSpec, createSourcesClient };

package/dist/sourcesClient.js

@@ -1,339 +0,0 @@
-// src/coreClient.ts
-var LucernApiError = class extends Error {
-  code;
-  status;
-  invariant;
-  suggestion;
-  details;
-  requestId;
-  correlationId;
-  policyTraceId;
-  constructor(args) {
-    super(args.message);
-    this.name = "LucernApiError";
-    this.code = args.code;
-    this.status = args.status;
-    this.invariant = args.invariant;
-    this.suggestion = args.suggestion;
-    this.details = args.details;
-    this.requestId = args.requestId;
-    this.correlationId = args.correlationId;
-    this.policyTraceId = args.policyTraceId;
-  }
-};
-function fillRandomBytes(length) {
-  const bytes = new Uint8Array(length);
-  if (typeof globalThis.crypto?.getRandomValues === "function") {
-    globalThis.crypto.getRandomValues(bytes);
-    return bytes;
-  }
-  for (let index = 0; index < length; index += 1) {
-    bytes[index] = Math.floor(Math.random() * 256);
-  }
-  return bytes;
-}
-function generatePortableRequestId() {
-  if (typeof globalThis.crypto?.randomUUID === "function") {
-    return globalThis.crypto.randomUUID();
-  }
-  const bytes = fillRandomBytes(16);
-  bytes[6] = bytes[6] & 15 | 64;
-  bytes[8] = bytes[8] & 63 | 128;
-  const hex = Array.from(bytes, (value) => value.toString(16).padStart(2, "0"));
-  return `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(
-    6,
-    8
-  ).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10).join("")}`;
-}
-function randomIdempotencyKey() {
-  return generatePortableRequestId();
-}
-function isRetryableStatus(status) {
-  return status >= 500 || status === 408 || status === 429;
-}
-function fallbackErrorCode(status) {
-  if (status === 401) {
-    return "AUTHENTICATION_REQUIRED";
-  }
-  if (status === 403) {
-    return "FORBIDDEN";
-  }
-  if (status === 404) {
-    return "NOT_FOUND";
-  }
-  if (status === 408) {
-    return "UPSTREAM_ERROR";
-  }
-  if (status === 409) {
-    return "CONFLICT";
-  }
-  if (status === 429) {
-    return "RATE_LIMIT_EXCEEDED";
-  }
-  if (status >= 500) {
-    return "UPSTREAM_ERROR";
-  }
-  return "INTERNAL_ERROR";
-}
-function delay(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function parseRetryAfterMs(value) {
-  if (!value) {
-    return null;
-  }
-  const trimmed = value.trim();
-  if (!trimmed) {
-    return null;
-  }
-  const numeric = Number(trimmed);
-  if (Number.isFinite(numeric)) {
-    return Math.max(0, Math.round(numeric * 1e3));
-  }
-  const parsedDate = Date.parse(trimmed);
-  if (Number.isFinite(parsedDate)) {
-    return Math.max(0, parsedDate - Date.now());
-  }
-  return null;
-}
-function computeRetryDelayMs(args) {
-  const baseDelay = args.status === 429 ? Math.max(
-    args.retryAfterMs ?? 0,
-    Math.min(1e3 * 2 ** args.attempt, 1e4)
-  ) : Math.min(1e3 * 2 ** args.attempt, 4e3);
-  if (args.status !== 429) {
-    return baseDelay;
-  }
-  const jitterWindow = Math.max(250, Math.round(baseDelay * 0.25));
-  return baseDelay + Math.round(Math.random() * jitterWindow);
-}
-function timeoutError(timeoutMs) {
-  const error = new Error(`Request timed out after ${timeoutMs}ms`);
-  error.name = "AbortError";
-  return error;
-}
-function readPolicySummaryFromDetails(details) {
-  if (!details || typeof details !== "object" || Array.isArray(details)) {
-    return null;
-  }
-  const directSummary = details.summary;
-  if (typeof directSummary === "string" && directSummary.trim().length > 0) {
-    return directSummary.trim();
-  }
-  const policy = details.policy;
-  if (!policy || typeof policy !== "object" || Array.isArray(policy)) {
-    return null;
-  }
-  const explanation = policy.explanation;
-  if (!explanation || typeof explanation !== "object" || Array.isArray(explanation)) {
-    return null;
-  }
-  const nestedSummary = explanation.summary;
-  if (typeof nestedSummary === "string" && nestedSummary.trim().length > 0) {
-    return nestedSummary.trim();
-  }
-  return null;
-}
-function createGatewayRequestClient(config = {}) {
-  const fetchImpl = config.fetchImpl ?? fetch;
-  const baseUrl = config.baseUrl?.replace(/\/+$/, "") ?? "";
-  const maxRetries = config.maxRetries ?? 2;
-  const requestIdFactory = config.requestIdFactory ?? (() => generatePortableRequestId());
-  async function resolveAuthHeaders() {
-    if (!config.getAuthHeaders) {
-      return {};
-    }
-    return await config.getAuthHeaders();
-  }
-  async function fetchWithTimeout(url, init, timeoutMs) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-      return await fetchImpl(url, { ...init, signal: controller.signal });
-    } catch (error) {
-      if (controller.signal.aborted) {
-        throw timeoutError(timeoutMs);
-      }
-      throw error;
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-  async function parsePayload(response) {
-    const text = await response.text();
-    if (!text) {
-      return null;
-    }
-    try {
-      return JSON.parse(text);
-    } catch {
-      return null;
-    }
-  }
-  function resolveTimeoutMs(method, requestTimeoutMs) {
-    if (typeof requestTimeoutMs === "number") {
-      return requestTimeoutMs;
-    }
-    const methodTimeoutMs = config.timeoutMsByMethod?.[method];
-    if (typeof methodTimeoutMs === "number") {
-      return methodTimeoutMs;
-    }
-    return config.timeoutMs ?? 15e3;
-  }
-  function buildApiError(args) {
-    const failure = args.failure;
-    const legacyError = failure && typeof failure.error === "object" && failure.error !== null ? failure.error : failure?.legacyError;
-    const correlationId = failure?.correlationId ?? args.response.headers.get("x-lucern-correlation-id")?.trim() ?? args.requestId;
-    const policyTraceId = failure?.policyTraceId ?? args.response.headers.get("x-lucern-policy-trace-id")?.trim() ?? null;
-    const details = failure?.details ?? legacyError?.details;
-    const policySummary = readPolicySummaryFromDetails(details);
-    return new LucernApiError({
-      code: failure?.code ?? legacyError?.code ?? fallbackErrorCode(args.response.status),
-      message: policySummary ?? (typeof failure?.error === "string" ? failure.error : legacyError?.message ?? (args.response.ok ? "Platform API returned an invalid success payload." : "Platform API request failed.")),
-      status: args.response.status,
-      invariant: failure?.invariant,
-      suggestion: failure?.suggestion,
-      details,
-      requestId: args.requestId,
-      correlationId,
-      policyTraceId
-    });
-  }
-  async function request(args) {
-    const authHeaders = await resolveAuthHeaders();
-    const method = args.method ?? "GET";
-    const timeoutMs = resolveTimeoutMs(method, args.timeoutMs);
-    const headers = new Headers({
-      "content-type": "application/json",
-      ...authHeaders
-    });
-    if (args.idempotencyKey) {
-      headers.set("idempotency-key", args.idempotencyKey);
-    }
-    const requestId = headers.get("x-correlation-id")?.trim() || headers.get("x-request-id")?.trim() || args.requestId || requestIdFactory();
-    if (!headers.has("x-correlation-id") && !headers.has("x-request-id")) {
-      headers.set("x-correlation-id", requestId);
-    }
-    const url = `${baseUrl}${args.path}`;
-    const serializedBody = args.body ? JSON.stringify(args.body) : void 0;
-    const init = {
-      method,
-      headers,
-      body: serializedBody
-    };
-    let lastError;
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
-      const hookRequestContext = {
-        requestId,
-        attempt,
-        maxRetries,
-        method,
-        path: args.path,
-        url,
-        headers: new Headers(headers),
-        body: serializedBody,
-        timeoutMs
-      };
-      await config.onRequest?.(hookRequestContext);
-      const startedAt = Date.now();
-      try {
-        const response = await fetchWithTimeout(url, init, timeoutMs);
-        const responseClone = response.clone();
-        const payload = await parsePayload(response);
-        const retryAfterMs = parseRetryAfterMs(
-          response.headers.get("Retry-After")
-        );
-        if (!response.ok || !payload?.success) {
-          const failure = payload && !payload.success ? payload : null;
-          const apiError = buildApiError({
-            requestId,
-            response,
-            failure
-          });
-          const willRetry = attempt < maxRetries && isRetryableStatus(response.status);
-          await config.onResponse?.({
-            ...hookRequestContext,
-            durationMs: Date.now() - startedAt,
-            status: response.status,
-            response: responseClone,
-            error: apiError,
-            correlationId: apiError.correlationId ?? requestId,
-            policyTraceId: apiError.policyTraceId ?? null,
-            retryAfterMs,
-            willRetry
-          });
-          if (willRetry) {
-            lastError = apiError;
-            await delay(
-              computeRetryDelayMs({
-                attempt,
-                status: response.status,
-                retryAfterMs
-              })
-            );
-            continue;
-          }
-          throw apiError;
-        }
-        const successPayload = payload;
-        await config.onResponse?.({
-          ...hookRequestContext,
-          durationMs: Date.now() - startedAt,
-          status: response.status,
-          response: responseClone,
-          correlationId: successPayload.correlationId ?? response.headers.get("x-lucern-correlation-id")?.trim() ?? requestId,
-          policyTraceId: successPayload.policyTraceId ?? response.headers.get("x-lucern-policy-trace-id")?.trim() ?? null,
-          idempotentReplay: successPayload.idempotentReplay,
-          retryAfterMs,
-          willRetry: false
-        });
-        return successPayload;
-      } catch (fetchError) {
-        if (fetchError instanceof LucernApiError) {
-          throw fetchError;
-        }
-        const willRetry = attempt < maxRetries;
-        await config.onResponse?.({
-          ...hookRequestContext,
-          durationMs: Date.now() - startedAt,
-          error: fetchError,
-          correlationId: requestId,
-          policyTraceId: null,
-          willRetry
-        });
-        lastError = fetchError;
-        if (willRetry) {
-          await delay(computeRetryDelayMs({ attempt }));
-        }
-      }
-    }
-    throw lastError instanceof Error ? lastError : new Error("Platform API request failed after retries.");
-  }
-  return {
-    request
-  };
-}
-
-// src/sourcesClient.ts
-function createSourcesClient(config = {}) {
-  const gateway = createGatewayRequestClient(config);
-  return {
-    async upsert(spec, idempotencyKey = randomIdempotencyKey()) {
-      return gateway.request({
-        path: "/api/platform/v1/sources/upsert",
-        method: "POST",
-        body: spec,
-        idempotencyKey
-      });
-    },
-    async get(sourceId) {
-      return gateway.request({
-        path: `/api/platform/v1/sources/${encodeURIComponent(sourceId)}`
-      });
-    }
-  };
-}
-
-export { LucernApiError, createSourcesClient };
-//# sourceMappingURL=sourcesClient.js.map
-//# sourceMappingURL=sourcesClient.js.map