@decibelsystems/tools 2.0.0

package/dist/tools/vector.d.ts

@@ -0,0 +1,189 @@
+/** Supported AI coding agent types */
+export type AgentType = 'claude-code' | 'cursor' | 'replit' | 'chatgpt' | 'custom';
+/** Information about the AI agent generating events */
+export interface AgentInfo {
+    type: AgentType;
+    version?: string;
+}
+/** All possible event types */
+export type EventType = 'prompt_received' | 'plan_proposed' | 'assumption_made' | 'clarifying_question' | 'command_ran' | 'file_touched' | 'test_result' | 'backtrack' | 'error' | 'user_correction' | 'run_completed' | 'delegation_sent' | 'delegation_received' | 'delegation_completed';
+/** Base event structure */
+export interface BaseEvent {
+    ts: string;
+    run_id: string;
+    agent: AgentInfo;
+    type: EventType;
+}
+/** Full event with type-specific payload */
+export interface VectorEvent extends BaseEvent {
+    payload?: Record<string, any>;
+}
+/** Intent specification from prompt analysis */
+export interface PromptIntent {
+    goal?: string;
+    scope?: string[];
+    non_goals?: string[];
+    constraints?: string[];
+    acceptance?: string[];
+    risk_posture?: 'safe' | 'moderate' | 'aggressive';
+}
+/** Reference to a delegating or delegated agent run */
+export interface DelegationRef {
+    agent_id: string;
+    run_id: string;
+}
+/** Prompt specification stored with each run */
+export interface PromptSpec {
+    run_id: string;
+    agent: AgentInfo;
+    raw_prompt: string;
+    intent?: PromptIntent;
+    anchors?: {
+        adrs?: string[];
+        memento_packs?: string[];
+    };
+    /** Who asked for this run (parent agent/run) */
+    delegated_by?: DelegationRef;
+    /** Sub-runs spawned from this run */
+    delegated_to?: DelegationRef[];
+    created_at: string;
+}
+/** Run summary information */
+export interface RunInfo {
+    run_id: string;
+    agent: AgentInfo;
+    created_at: string;
+    completed_at?: string;
+    event_count: number;
+    success?: boolean;
+    summary?: string;
+}
+/** Inference load score breakdown */
+export interface ScoreBreakdown {
+    nonGoals?: number;
+    acceptance?: number;
+    constraints?: number;
+    scopeBounds?: number;
+    ambiguousVerbs?: number;
+    undefinedNouns?: number;
+    unguardedRiskAreas?: number;
+}
+/** Suggestion for reducing inference load */
+export interface Suggestion {
+    type: 'add_non_goals' | 'add_acceptance' | 'add_constraints' | 'add_scope' | 'clarify_verbs' | 'bind_nouns' | 'guard_risk';
+    message: string;
+    priority: 'high' | 'medium' | 'low';
+}
+/** Complete inference score result */
+export interface InferenceScore {
+    score: number;
+    breakdown: ScoreBreakdown;
+    suggestions: Suggestion[];
+    risk_level: 'low' | 'medium' | 'high' | 'critical';
+}
+export interface CreateRunInput {
+    projectId?: string;
+    project_id?: string;
+    agent: AgentInfo;
+    raw_prompt: string;
+    intent?: PromptIntent;
+    /** If this run was delegated from another agent */
+    delegated_by?: DelegationRef;
+}
+export interface LogEventInput {
+    projectId?: string;
+    project_id?: string;
+    run_id: string;
+    type: EventType;
+    payload?: Record<string, any>;
+}
+export interface CompleteRunInput {
+    projectId?: string;
+    project_id?: string;
+    run_id: string;
+    success: boolean;
+    summary?: string;
+}
+export interface ListRunsInput {
+    projectId?: string;
+    project_id?: string;
+    limit?: number;
+    agent_type?: AgentType;
+}
+export interface GetRunInput {
+    projectId?: string;
+    project_id?: string;
+    run_id: string;
+    include_events?: boolean;
+}
+export interface ScorePromptInput {
+    prompt: string;
+    projectId?: string;
+    project_id?: string;
+}
+/**
+ * Create a new run for an agent session
+ */
+export declare function createRun(input: CreateRunInput): Promise<{
+    run_id: string;
+    path: string;
+    imported_events?: number;
+}>;
+/**
+ * Log an event to an existing run
+ */
+export declare function logEvent(input: LogEventInput): Promise<{
+    success: true;
+    event_count: number;
+}>;
+/**
+ * Complete a run with summary
+ */
+export declare function completeRun(input: CompleteRunInput): Promise<{
+    success: true;
+    run_id: string;
+}>;
+/**
+ * List runs for a project
+ */
+export declare function listRuns(input: ListRunsInput): Promise<{
+    runs: RunInfo[];
+}>;
+/**
+ * Get details of a specific run
+ */
+export declare function getRun(input: GetRunInput): Promise<{
+    prompt: PromptSpec;
+    events?: VectorEvent[];
+    event_count: number;
+    completed: boolean;
+}>;
+export interface VectorTraceInput {
+    projectId?: string;
+    project_id?: string;
+    run_id: string;
+    /** Max depth to walk (default: 10) */
+    depth?: number;
+}
+export interface TraceNode {
+    run_id: string;
+    agent: AgentInfo;
+    created_at: string;
+    completed: boolean;
+    success?: boolean;
+    parent?: DelegationRef;
+    children: TraceNode[];
+}
+/**
+ * Walk delegation chain from a run_id and return the full tree.
+ * Goes up to the root parent, then down through all children.
+ */
+export declare function vectorTrace(input: VectorTraceInput): Promise<{
+    root: TraceNode;
+    depth: number;
+}>;
+/**
+ * Calculate inference load score for a prompt
+ */
+export declare function scorePrompt(input: ScorePromptInput): InferenceScore;
+//# sourceMappingURL=vector.d.ts.map

package/dist/tools/vector.d.ts.map

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