@tyvm/knowhow 0.0.159 → 0.0.160

package/src/types.ts

@@ -1,282 +0,0 @@
-import { AssistantTool } from "openai/resources/beta";
-import { WebSocket } from "ws";
-
-/**
- * Flexible hash store. Each key is either:
- *   - a file path (legacy): { fileHash, promptHash, [promptHash]: fileHash }
- *   - a named build slot (new): { [inputKey: string]: hashValue }
- *
- * Both formats use the same shape: an object of string→string pairs.
- * `fileHash` and `promptHash` are just conventional keys in the legacy format.
- */
-export type Hashes = {
-  [key: string]: {
-    [inputKey: string]: string;
-  };
-};
-
-/**
- * A reference to an external JSON file containing an array of GenerationSource
- * or EmbedSource entries. Used in knowhow.json `sources` / `embedSources` arrays
- * to split a large config across multiple files:
- *   { "from": "./generate/autodoc.json" }
- */
-export type SourceRef = { from: string };
-
-export type GenerationSource = {
-  model?: string;
-  agent?: string;
-  name?: string;
-  input: string;
-  output: string;
-  prompt: string;
-  kind?: string;
-  outputExt?: string;
-  outputName?: string;
-  /** Pass to runAgentTask: enable .knowhow/processes/agents/<taskId> directory */
-  syncFs?: boolean;
-  /**
-   * Pass to runAgentTask: push the agent's work to a remote Knowhow task
-   * (identified by this source's taskId).
-   */
-  syncRemote?: boolean;
-  /**
-   * Deterministic task ID for this source (used with syncFs).
-   * Defaults to "generate:<sanitized-output>" when syncFs is enabled.
-   */
-  taskId?: string;
-  /** Time limit in minutes for the agent (optional) */
-  maxTimeLimit?: number;
-  /** Cost limit in dollars for the agent (optional) */
-  maxSpendLimit?: number;
-  /**
-   * Names of other GenerationSource entries (by `name` field) that must
-   * complete before this source runs. Used for explicit dependency ordering
-   * when automatic I/O overlap detection is insufficient.
-   */
-  dependsOn?: string[];
-};
-
-export type EmbedSource = {
-  input: string;
-  output: string;
-  prompt?: string;
-  kind?: string;
-  uploadMode?: boolean;
-  remote?: string;
-  remoteType?: string;
-  remoteId?: string;
-  chunkSize?: number;
-  minLength?: number;
-};
-
-export type KnowhowRemote = {
-  name: string;
-  apiUrl: string;
-  jwtPath: string;
-  orgId?: string;
-};
-
-export type Config = {
-  openaiBaseUrl?: string;
-  promptsDir: string;
-  lintCommands?: { [fileExtension: string]: string };
-  /** Legacy organization field; migrated into the selected remote on login. */
-  orgId?: string;
-  /** Legacy environment map retained for reading pre-remote configurations. */
-  orgIds?: Record<string, string>;
-  remotes?: Record<string, KnowhowRemote>;
-  activeRemote?: string;
-  /** Private Ed25519 identity selected with `knowhow login --identity`. */
-  cliIdentityPath?: string;
-  syncRemote?: boolean;
-  micCommand?: string;
-  defaultMic?: string;
-  sources: GenerationSource[];
-  embedSources: EmbedSource[];
-  embeddingModel: string;
-  skills?: string[];
-  plugins: { enabled: string[]; disabled: string[] };
-  chat?: {
-    rootModule?: string;
-    renderer?: string;
-    defaultAgent?: string;
-    defaultModel?: string;
-    defaultProvider?: string;
-    modules?: string[];
-  };
-  modules: string[];
-  agents: Assistant[];
-  mcps: McpConfig[];
-  modelProviders: ModelProvider[];
-  ycmd?: {
-    enabled?: boolean;
-    installPath?: string;
-    port?: number;
-    logLevel?: "debug" | "info" | "warning" | "error";
-    completionTimeout?: number;
-  };
-  files?: {
-    remotePath: string;
-    localPath: string;
-    direction?: "download" | "upload" | "sync";
-  }[];
-  worker?: {
-    allowedTools?: string[];
-    workerId?: string;
-    sandbox?: boolean;
-    volumes?: string[];
-    envFile?: string;
-    auth?: {
-      required?: boolean;
-      passkey?: {
-        publicKey?: string;
-        credentialId?: string;
-        algorithm?: string;
-      };
-      sessionDurationHours?: number;
-    };
-    commandAuth?: { [toolName: string]: "always" | "session" | "never" };
-    tunnel?: {
-      enabled?: boolean;
-      allowedPorts?: number[];
-      maxConcurrentStreams?: number;
-      portMapping?: { [containerPort: number]: number };
-      localHost?: string;
-      enableUrlRewriting?: boolean;
-    };
-  };
-};
-
-export type Assistant = {
-  name?: string;
-  description?: string;
-  instructions: string;
-  model?: string;
-  provider?: keyof typeof Providers;
-};
-
-export type McpConfig = {
-  name: string;
-  autoConnect?: boolean;
-  command?: string;
-  url?: string;
-  args?: string[];
-  env?: { [key: string]: string };
-  params?: Partial<{ socket: WebSocket }>;
-  authorization_token?: string;
-  authorization_token_file?: string;
-  authorization_scheme?: "bearer" | "basic";
-};
-
-export type ModelProvider = {
-  url?: string;
-  provider: string;
-  envKey?: string;
-  headers?: { [key: string]: string };
-  jwtFile?: string;
-  timeout?: number;
-  extra_body?: Record<string, any>;
-  /** Optional pricing map (model id → per-million-token prices) passed to HttpClient.setPrices() */
-  pricing?: Record<string, { input?: number; output?: number; cached_input?: number; cache_hit?: number }>;
-};
-
-export type AssistantConfig = {
-  files: { [filepath: string]: string };
-};
-
-export interface Embeddable<T = any> {
-  id: string;
-  text: string;
-  vector: number[];
-  metadata: T;
-}
-
-export type MinimalEmbedding<T = any> = Pick<Embeddable<T>, "id" | "text" | "metadata">;
-
-export interface EmbeddingBase<T = any> extends Embeddable<T> {
-  similarity?: number;
-}
-
-export type GptQuestionEmbedding = any & EmbeddingBase;
-export type DatasourceType = "file" | "url" | "text";
-
-export interface IDatasource {
-  kind: string;
-  data: string[];
-}
-
-export type Language = {
-  [term: string]: {
-    events: string[];
-    sources: IDatasource[];
-    context?: string;
-    handled?: boolean;
-  };
-};
-
-export type ChatInteraction = {
-  input: string;
-  output: string;
-  taskId: string;
-};
-
-// ─── Model IDs ────────────────────────────────────────────────────────────────
-// Each provider's pricing file is the single source of truth.
-
-import { AnthropicModels, AnthropicTextModels } from "./clients/pricing/anthropic";
-import {
-  OpenAiModels, OpenAiEmbeddingModels,
-  OpenAiReasoningModels, OpenAiChatModels, OpenAiEmbeddingModelsList,
-  OpenAiResponsesOnlyModels, OpenAiImageModels, OpenAiVideoModels,
-  OpenAiTTSModels, OpenAiTranscriptionModels, OpenAiRealtimeModels,
-} from "./clients/pricing/openai";
-import {
-  GoogleModels, GoogleEmbeddingModels,
-  GoogleTextModels, GoogleImageModels, GoogleVideoModels,
-  GoogleTTSModels, GoogleEmbeddingModelsList, GoogleThinkingLevelModels, GoogleThinkingBudgetModels,
-} from "./clients/pricing/google";
-import {
-  XaiModels, XaiTextModels, XaiImageModels, XaiVideoModels, XaiResponsesOnlyModels, XaiReasoningModels,
-} from "./clients/pricing/xai";
-import { FireworksModels } from "./clients/pricing/fireworks";
-
-export const Models = {
-  anthropic: AnthropicModels,
-  xai: XaiModels,
-  openai: OpenAiModels,
-  google: GoogleModels,
-  fireworks: FireworksModels,
-};
-
-export const EmbeddingModels = {
-  openai: OpenAiEmbeddingModels,
-  google: GoogleEmbeddingModels,
-};
-
-// Re-export modality arrays for consumers
-export {
-  OpenAiReasoningModels, OpenAiChatModels, OpenAiEmbeddingModelsList,
-  OpenAiResponsesOnlyModels, OpenAiImageModels, OpenAiVideoModels,
-  OpenAiTTSModels, OpenAiTranscriptionModels, OpenAiRealtimeModels,
-  GoogleTextModels as GoogleReasoningModels,
-  GoogleImageModels, GoogleVideoModels, GoogleTTSModels, GoogleEmbeddingModelsList,
-  GoogleThinkingLevelModels, GoogleThinkingBudgetModels,
-  AnthropicTextModels,
-  XaiTextModels, XaiImageModels, XaiVideoModels, XaiResponsesOnlyModels, XaiReasoningModels,
-};
-
-export function getEnabledPlugins(plugins: Config["plugins"] | undefined): string[] {
-  if (!plugins) return [];
-  return plugins.enabled ?? [];
-}
-
-export function getDisabledPlugins(plugins: Config["plugins"] | undefined): string[] {
-  if (!plugins) return [];
-  return plugins.disabled ?? [];
-}
-
-export const Providers = Object.keys(Models).reduce((obj, key) => {
-  obj[key] = key;
-  return obj;
-}, {}) as { [key in keyof typeof Models]: keyof typeof Models };

package/src/util/Trace.ts

@@ -1,236 +0,0 @@
-/**
- * Trace.ts — Method / class decorators and `tracify()` helper for the
- * @tyvm/knowhow package.
- *
- * These decorators are zero-cost when no tracer is registered (the default).
- * Once `@tyvm/knowhow-module-tracing` (or any other module) calls
- * `TracingService.register(impl)`, every decorated method starts emitting
- * real spans automatically — no code changes required.
- *
- * API mirrors the backend's `Trace.ts` so patterns learned there carry over:
- *
- *   @Trace()            — wrap a single method
- *   @TraceAll()         — wrap every public method on a class
- *   tracify(obj, ns)    — wrap an already-constructed instance
- *
- * @example
- * import { Trace, TraceAll, tracify } from '../util/Trace';
- *
- * @TraceAll()
- * export class MessageProcessor {
- *   async process(msg: Message) { ... }  // → span "MessageProcessor.process"
- * }
- *
- * @Trace()
- * async fetchEmbeddings(text: string) { ... }  // → span "ClassName.fetchEmbeddings"
- *
- * export const myClient = tracify(new SomeClient(), 'someClient');
- */
-
-import { TracingService } from "../services/TracingService";
-
-// ─── Shared span lifecycle helper ─────────────────────────────────────────────
-
-function runWithSpan<T>(
-  spanName: string,
-  attributes: Record<string, string | number | boolean>,
-  fn: () => T
-): T {
-  const span = TracingService.startSpan(spanName, attributes);
-
-  const finish = (err?: unknown) => {
-    if (err !== undefined) {
-      span.recordError(err);
-    }
-    span.end();
-  };
-
-  try {
-    const result = TracingService.withSpan(span, fn);
-
-    if (result instanceof Promise) {
-      return result.then(
-        (value) => {
-          finish();
-          return value;
-        },
-        (err) => {
-          finish(err);
-          throw err;
-        }
-      ) as unknown as T;
-    }
-
-    finish();
-    return result;
-  } catch (err) {
-    finish(err);
-    throw err;
-  }
-}
-
-// ─── @Trace() — single-method decorator ──────────────────────────────────────
-
-export interface TraceOptions {
-  /** Override the span name (default: `ClassName.methodName`) */
-  spanName?: string;
-  /** Additional static attributes attached to every span */
-  attributes?: Record<string, string | number | boolean>;
-}
-
-/**
- * @Trace() method decorator — wraps the decorated method in a tracing span.
- *
- * Span name defaults to `ClassName.methodName`. Errors are recorded on the
- * span and re-thrown. Works with both sync and async methods.
- *
- * @example
- * @Trace()
- * async fetchEmbeddings(text: string) { ... }
- *
- * @Trace({ spanName: 'embeddings.fetch', attributes: { 'peer.service': 'openai' } })
- * async fetchEmbeddings(text: string) { ... }
- */
-export function Trace(options: TraceOptions = {}) {
-  return function (
-    target: object,
-    propertyKey: string,
-    descriptor: PropertyDescriptor
-  ): PropertyDescriptor {
-    const originalMethod = descriptor.value as (...args: unknown[]) => unknown;
-    const className = (target as any).constructor?.name ?? "Unknown";
-    const resolvedSpanName =
-      options.spanName ?? `${className}.${propertyKey}`;
-    const staticAttrs: Record<string, string | number | boolean> = {
-      "code.function": propertyKey,
-      "code.namespace": className,
-      ...options.attributes,
-    };
-
-    descriptor.value = function (this: unknown, ...args: unknown[]) {
-      return runWithSpan(resolvedSpanName, staticAttrs, () =>
-        originalMethod.apply(this, args)
-      );
-    };
-
-    return descriptor;
-  };
-}
-
-// ─── @TraceAll() — class decorator ───────────────────────────────────────────
-
-export interface TraceAllOptions {
-  /** Additional static attributes attached to every span */
-  attributes?: Record<string, string | number | boolean>;
-  /** Method names to skip (in addition to constructor and `_`-prefixed) */
-  skip?: string[];
-}
-
-/**
- * @TraceAll() class decorator — wraps every public method on the class in a
- * tracing span named `ClassName.methodName`.
- *
- * Skips the constructor and any methods whose name starts with `_`.
- *
- * @example
- * @TraceAll()
- * export class MessageProcessor {
- *   async process(msg: Message) { ... }  // → span "MessageProcessor.process"
- * }
- */
-export function TraceAll(options: TraceAllOptions = {}) {
-  const skip = new Set(options.skip ?? []);
-
-  return function <T extends abstract new (...args: unknown[]) => object>(
-    constructor: T
-  ): T {
-    const className = constructor.name;
-    const proto = constructor.prototype as Record<string, unknown>;
-
-    for (const key of Object.getOwnPropertyNames(proto)) {
-      if (key === "constructor") continue;
-      if (key.startsWith("_")) continue;
-      if (skip.has(key)) continue;
-
-      const descriptor = Object.getOwnPropertyDescriptor(proto, key);
-      if (!descriptor || typeof descriptor.value !== "function") continue;
-
-      const originalMethod = descriptor.value as (
-        ...args: unknown[]
-      ) => unknown;
-      const spanName = `${className}.${key}`;
-      const staticAttrs: Record<string, string | number | boolean> = {
-        "code.function": key,
-        "code.namespace": className,
-        ...options.attributes,
-      };
-
-      descriptor.value = function (this: unknown, ...args: unknown[]) {
-        return runWithSpan(spanName, staticAttrs, () =>
-          originalMethod.apply(this, args)
-        );
-      };
-
-      Object.defineProperty(proto, key, descriptor);
-    }
-
-    return constructor;
-  };
-}
-
-// ─── tracify() — instance-level wrapper ──────────────────────────────────────
-
-/**
- * tracify — wraps every method on an already-constructed object instance in a
- * tracing span.
- *
- * Ideal for third-party singletons (SDK clients etc.) that cannot be decorated
- * at the class level.
- *
- * @param instance   The object whose methods should be traced.
- * @param namespace  Prefix for span names, e.g. "embeddingsClient".
- * @param options    Optional extra attributes / skip list.
- *
- * @example
- * export const embeddingsClient = tracify(new OpenAI(), 'openai');
- */
-export function tracify<T extends object>(
-  instance: T,
-  namespace: string,
-  options: TraceAllOptions = {}
-): T {
-  const skip = new Set(options.skip ?? []);
-
-  return new Proxy(instance, {
-    get(target, prop, receiver) {
-      const value = Reflect.get(target, prop, receiver);
-      const methodName = typeof prop === "string" ? prop : String(prop);
-
-      // Pass symbols through unwrapped
-      if (typeof prop === "symbol") return value;
-
-      // Skip private / user-skipped names
-      if (methodName.startsWith("_") || skip.has(methodName)) return value;
-
-      // Recursively wrap nested objects (e.g. prisma.user.findMany)
-      if (value !== null && typeof value === "object") {
-        return tracify(value as object, `${namespace}.${methodName}`, options);
-      }
-
-      if (typeof value !== "function") return value;
-
-      const spanName = `${namespace}.${methodName}`;
-      const staticAttrs: Record<string, string | number | boolean> = {
-        "code.function": methodName,
-        "code.namespace": namespace,
-        ...options.attributes,
-      };
-
-      return function (this: unknown, ...args: unknown[]) {
-        return runWithSpan(spanName, staticAttrs, () =>
-          (value as Function).apply(target, args)
-        );
-      };
-    },
-  });
-}