qlogicagent 0.2.1 → 0.4.0

package/dist/contracts/planner.js

@@ -1,2 +0,0 @@
-export const TASK_STEP_STATUS_VALUES = ["pending", "in-progress", "completed", "skipped"];
-export const TASK_PLAN_STATUS_VALUES = ["active", "completed", "abandoned"];

package/dist/contracts/skill-candidate.d.ts

@@ -1,63 +0,0 @@
-export declare const SKILL_CANDIDATE_STATUS_VALUES: readonly ["draft", "in_review", "approved", "rejected", "canary", "published", "stale", "superseded", "rolled_back"];
-export declare const SKILL_CANDIDATE_ACTION_VALUES: readonly ["submit-review", "approve", "reject", "start-canary", "record-effectiveness", "promote", "publish", "mark-stale", "mark-superseded", "rollback"];
-export declare const SKILL_CANDIDATE_EFFECTIVENESS_PHASE_VALUES: readonly ["canary", "published"];
-export type SkillCandidateStatus = (typeof SKILL_CANDIDATE_STATUS_VALUES)[number];
-export type SkillCandidateAction = (typeof SKILL_CANDIDATE_ACTION_VALUES)[number];
-export type SkillCandidateEffectivenessPhase = (typeof SKILL_CANDIDATE_EFFECTIVENESS_PHASE_VALUES)[number];
-export type SkillCandidateArtifactContract = {
-    uri: string;
-    sha256?: string;
-    workspaceDir?: string;
-    relativePath?: string;
-    sourceWorkspaceDir?: string;
-    stagedAt?: string;
-};
-export type SkillCandidateSourceExecutionContract = {
-    executionId?: string;
-    rootExecutionId?: string;
-    parentExecutionId?: string;
-    sidechainId?: string;
-    attemptId?: string;
-    outcomeId?: string;
-    sessionId?: string;
-    turnId?: string;
-};
-export type SkillCandidateReviewContract = {
-    action: SkillCandidateAction;
-    actor?: string | null;
-    notes?: string | null;
-    payload?: Record<string, unknown>;
-    createdAt?: string;
-};
-export type SkillCandidateEffectivenessContract = {
-    phase: SkillCandidateEffectivenessPhase;
-    sampleCount: number;
-    successCount: number;
-    failureCount: number;
-    regressionCount: number;
-    successRate: number;
-    regressionRate: number;
-    avgLatencyMs?: number;
-    avgCostUsd?: number;
-    score?: number;
-    staleReason?: string | null;
-    notes?: string | null;
-    summary?: Record<string, unknown>;
-    lastObservedAt?: string;
-    updatedAt?: string;
-    /** ISO-8601 timestamp of last skill invocation/view/patch activity. */
-    lastActivityAt?: string;
-    /** Cumulative activity count (use + view + patch). */
-    activityCount?: number;
-};
-export declare function coerceSkillCandidateJsonObject(value: unknown): Record<string, unknown>;
-export declare function isSkillCandidateStatus(value: unknown): value is SkillCandidateStatus;
-export declare function isSkillCandidateAction(value: unknown): value is SkillCandidateAction;
-export declare function isSkillCandidateEffectivenessPhase(value: unknown): value is SkillCandidateEffectivenessPhase;
-export declare function normalizeSkillCandidateStatus(value: unknown, fallback?: SkillCandidateStatus): SkillCandidateStatus;
-export declare function normalizeSkillCandidateAction(value: unknown): SkillCandidateAction | null;
-export declare function normalizeSkillCandidateEffectivenessPhase(value: unknown): SkillCandidateEffectivenessPhase | null;
-export declare function normalizeSkillCandidateArtifact(value: unknown): SkillCandidateArtifactContract | null;
-export declare function normalizeSkillCandidateSourceExecution(value: unknown): SkillCandidateSourceExecutionContract | null;
-export declare function normalizeSkillCandidateReview(value: unknown): SkillCandidateReviewContract | null;
-export declare function normalizeSkillCandidateEffectiveness(value: unknown): SkillCandidateEffectivenessContract | null;

package/dist/contracts/skill-candidate.js

@@ -1,195 +0,0 @@
-export const SKILL_CANDIDATE_STATUS_VALUES = [
-    "draft",
-    "in_review",
-    "approved",
-    "rejected",
-    "canary",
-    "published",
-    "stale",
-    "superseded",
-    "rolled_back",
-];
-export const SKILL_CANDIDATE_ACTION_VALUES = [
-    "submit-review",
-    "approve",
-    "reject",
-    "start-canary",
-    "record-effectiveness",
-    "promote",
-    "publish",
-    "mark-stale",
-    "mark-superseded",
-    "rollback",
-];
-export const SKILL_CANDIDATE_EFFECTIVENESS_PHASE_VALUES = ["canary", "published"];
-function normalizeOptionalString(value) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    return trimmed ? trimmed : undefined;
-}
-function normalizeOptionalFiniteNumber(value) {
-    if (typeof value === "number" && Number.isFinite(value)) {
-        return value;
-    }
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    if (!trimmed) {
-        return undefined;
-    }
-    const parsed = Number(trimmed);
-    return Number.isFinite(parsed) ? parsed : undefined;
-}
-function normalizeCount(value, fallback = 0) {
-    const normalized = normalizeOptionalFiniteNumber(value);
-    if (normalized === undefined) {
-        return Math.max(0, Math.floor(fallback));
-    }
-    return Math.max(0, Math.floor(normalized));
-}
-export function coerceSkillCandidateJsonObject(value) {
-    return value && typeof value === "object" && !Array.isArray(value)
-        ? { ...value }
-        : {};
-}
-export function isSkillCandidateStatus(value) {
-    return typeof value === "string"
-        && SKILL_CANDIDATE_STATUS_VALUES.includes(value);
-}
-export function isSkillCandidateAction(value) {
-    return typeof value === "string"
-        && SKILL_CANDIDATE_ACTION_VALUES.includes(value);
-}
-export function isSkillCandidateEffectivenessPhase(value) {
-    return typeof value === "string"
-        && SKILL_CANDIDATE_EFFECTIVENESS_PHASE_VALUES.includes(value);
-}
-export function normalizeSkillCandidateStatus(value, fallback = "draft") {
-    const normalized = normalizeOptionalString(value);
-    return normalized && isSkillCandidateStatus(normalized) ? normalized : fallback;
-}
-export function normalizeSkillCandidateAction(value) {
-    const normalized = normalizeOptionalString(value);
-    return normalized && isSkillCandidateAction(normalized) ? normalized : null;
-}
-export function normalizeSkillCandidateEffectivenessPhase(value) {
-    const normalized = normalizeOptionalString(value);
-    return normalized && isSkillCandidateEffectivenessPhase(normalized) ? normalized : null;
-}
-export function normalizeSkillCandidateArtifact(value) {
-    const record = coerceSkillCandidateJsonObject(value);
-    const uri = normalizeOptionalString(record.uri);
-    if (!uri) {
-        return null;
-    }
-    const sha256 = normalizeOptionalString(record.sha256);
-    const workspaceDir = normalizeOptionalString(record.workspaceDir);
-    const relativePath = normalizeOptionalString(record.relativePath);
-    const sourceWorkspaceDir = normalizeOptionalString(record.sourceWorkspaceDir);
-    const stagedAt = normalizeOptionalString(record.stagedAt);
-    return {
-        uri,
-        ...(sha256 ? { sha256 } : {}),
-        ...(workspaceDir ? { workspaceDir } : {}),
-        ...(relativePath ? { relativePath } : {}),
-        ...(sourceWorkspaceDir ? { sourceWorkspaceDir } : {}),
-        ...(stagedAt ? { stagedAt } : {}),
-    };
-}
-export function normalizeSkillCandidateSourceExecution(value) {
-    const record = coerceSkillCandidateJsonObject(value);
-    const executionId = normalizeOptionalString(record.executionId);
-    const rootExecutionId = normalizeOptionalString(record.rootExecutionId);
-    const parentExecutionId = normalizeOptionalString(record.parentExecutionId);
-    const sidechainId = normalizeOptionalString(record.sidechainId);
-    const attemptId = normalizeOptionalString(record.attemptId);
-    const outcomeId = normalizeOptionalString(record.outcomeId);
-    const sessionId = normalizeOptionalString(record.sessionId);
-    const turnId = normalizeOptionalString(record.turnId);
-    if (!executionId
-        && !rootExecutionId
-        && !parentExecutionId
-        && !sidechainId
-        && !attemptId
-        && !outcomeId
-        && !sessionId
-        && !turnId) {
-        return null;
-    }
-    return {
-        ...(executionId ? { executionId } : {}),
-        ...(rootExecutionId ? { rootExecutionId } : {}),
-        ...(parentExecutionId ? { parentExecutionId } : {}),
-        ...(sidechainId ? { sidechainId } : {}),
-        ...(attemptId ? { attemptId } : {}),
-        ...(outcomeId ? { outcomeId } : {}),
-        ...(sessionId ? { sessionId } : {}),
-        ...(turnId ? { turnId } : {}),
-    };
-}
-export function normalizeSkillCandidateReview(value) {
-    const record = coerceSkillCandidateJsonObject(value);
-    const action = normalizeSkillCandidateAction(record.action);
-    if (!action) {
-        return null;
-    }
-    const actor = normalizeOptionalString(record.actor) ?? null;
-    const notes = normalizeOptionalString(record.notes) ?? null;
-    const payload = coerceSkillCandidateJsonObject(record.payload);
-    const createdAt = normalizeOptionalString(record.createdAt);
-    return {
-        action,
-        actor,
-        notes,
-        payload,
-        ...(createdAt ? { createdAt } : {}),
-    };
-}
-export function normalizeSkillCandidateEffectiveness(value) {
-    const record = coerceSkillCandidateJsonObject(value);
-    const phase = normalizeSkillCandidateEffectivenessPhase(record.phase);
-    if (!phase) {
-        return null;
-    }
-    const successCount = normalizeCount(record.successCount);
-    const explicitFailureCount = normalizeOptionalFiniteNumber(record.failureCount);
-    const sampleCount = normalizeCount(record.sampleCount, explicitFailureCount !== undefined ? successCount + explicitFailureCount : successCount);
-    const failureCount = normalizeCount(record.failureCount, Math.max(sampleCount - successCount, 0));
-    const regressionCount = normalizeCount(record.regressionCount);
-    const successRate = normalizeOptionalFiniteNumber(record.successRate)
-        ?? (sampleCount > 0 ? successCount / sampleCount : 0);
-    const regressionRate = normalizeOptionalFiniteNumber(record.regressionRate)
-        ?? (sampleCount > 0 ? regressionCount / sampleCount : 0);
-    const avgLatencyMs = normalizeOptionalFiniteNumber(record.avgLatencyMs);
-    const avgCostUsd = normalizeOptionalFiniteNumber(record.avgCostUsd);
-    const score = normalizeOptionalFiniteNumber(record.score);
-    const staleReason = normalizeOptionalString(record.staleReason) ?? null;
-    const notes = normalizeOptionalString(record.notes) ?? null;
-    const summary = coerceSkillCandidateJsonObject(record.summary);
-    const lastObservedAt = normalizeOptionalString(record.lastObservedAt);
-    const updatedAt = normalizeOptionalString(record.updatedAt);
-    const lastActivityAt = normalizeOptionalString(record.lastActivityAt);
-    const activityCount = normalizeOptionalFiniteNumber(record.activityCount);
-    return {
-        phase,
-        sampleCount,
-        successCount,
-        failureCount,
-        regressionCount,
-        successRate,
-        regressionRate,
-        ...(avgLatencyMs !== undefined ? { avgLatencyMs } : {}),
-        ...(avgCostUsd !== undefined ? { avgCostUsd } : {}),
-        ...(score !== undefined ? { score } : {}),
-        ...(staleReason ? { staleReason } : {}),
-        ...(notes ? { notes } : {}),
-        ...(Object.keys(summary).length > 0 ? { summary } : {}),
-        ...(lastObservedAt ? { lastObservedAt } : {}),
-        ...(updatedAt ? { updatedAt } : {}),
-        ...(lastActivityAt ? { lastActivityAt } : {}),
-        ...(activityCount !== undefined ? { activityCount } : {}),
-    };
-}

package/dist/contracts/todo.d.ts

@@ -1,14 +0,0 @@
-export declare const TODO_ITEM_STATUS_VALUES: readonly ["not-started", "in-progress", "completed"];
-export type TodoItemStatus = (typeof TODO_ITEM_STATUS_VALUES)[number];
-export interface TodoItem {
-    id: number;
-    title: string;
-    status: TodoItemStatus;
-}
-export interface TodoListSummary {
-    total: number;
-    completed: number;
-    inProgress: number;
-    notStarted: number;
-}
-export declare function summarizeTodoList(items: readonly TodoItem[]): TodoListSummary;

package/dist/contracts/todo.js

@@ -1,9 +0,0 @@
-export const TODO_ITEM_STATUS_VALUES = ["not-started", "in-progress", "completed"];
-export function summarizeTodoList(items) {
-    return {
-        total: items.length,
-        completed: items.filter((item) => item.status === "completed").length,
-        inProgress: items.filter((item) => item.status === "in-progress").length,
-        notStarted: items.filter((item) => item.status === "not-started").length,
-    };
-}

package/dist/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * qlogicagent — Public API surface.
- *
- * Re-exports core types and constructors for programmatic embedding.
- */
-export { Agent } from "./agent/agent.js";
-export type { AgentLogger, ChatMessage, ToolDefinition, ToolInvoker, TurnConfig, TurnEvent, TurnRequest, HookRegistry, } from "./agent/types.js";
-export { parseCliArgs } from "./config/config.js";
-export type { AgentConfig } from "./config/config.js";
-export { ProviderRegistry, createLLMClient, autoDetectProvider, } from "./llm/index.js";
-export type { LLMTransport, LLMRequest, LLMChunk } from "./llm/index.js";
-export { createHookRegistry } from "./runtime/hook-registry.js";
-export { buildSkillInstruction, shouldCreateSkill, shouldImproveSkill, } from "./orchestration/index.js";

package/dist/index.js

@@ -1,15 +0,0 @@
-/**
- * qlogicagent — Public API surface.
- *
- * Re-exports core types and constructors for programmatic embedding.
- */
-// ── Agent ──────────────────────────────────────────────────
-export { Agent } from "./agent/agent.js";
-// ── Config ─────────────────────────────────────────────────
-export { parseCliArgs } from "./config/config.js";
-// ── LLM layer ──────────────────────────────────────────────
-export { ProviderRegistry, createLLMClient, autoDetectProvider, } from "./llm/index.js";
-// ── Runtime ────────────────────────────────────────────────
-export { createHookRegistry } from "./runtime/hook-registry.js";
-// ── Orchestration ──────────────────────────────────────────
-export { buildSkillInstruction, shouldCreateSkill, shouldImproveSkill, } from "./orchestration/index.js";

package/dist/llm/builtin-providers.d.ts

@@ -1,10 +0,0 @@
-/**
- * Builtin provider definitions — hardcoded fallback list (~30 providers).
- *
- * This is Layer 1 (lowest priority) of the three-layer merge strategy.
- * Used when remote model catalog is unavailable.
- *
- * Aligned with Hermes hermes_cli/models.py hardcoded fallback.
- */
-import type { ProviderDef } from "./provider-def.js";
-export declare const BUILTIN_PROVIDERS: ProviderDef[];