@vraxis/agent-v 0.4.0

package/dist/core/registry.js

@@ -0,0 +1,29 @@
+import { AgentVError } from "./errors.js";
+export class EngineRegistry {
+    engines = new Map();
+    register(engine) {
+        if (this.engines.has(engine.descriptor.id))
+            throw new Error(`Engine ${engine.descriptor.id} is already registered.`);
+        this.engines.set(engine.descriptor.id, engine);
+        return this;
+    }
+    get(id) {
+        return this.engines.get(id);
+    }
+    require(id, kind) {
+        const engine = this.engines.get(id);
+        if (!engine || (kind && engine.descriptor.kind !== kind)) {
+            throw new AgentVError("engine-unavailable", `No ${kind ?? "agent"} engine named ${id} is registered.`);
+        }
+        return engine;
+    }
+    find(kind, capabilities = []) {
+        return [...this.engines.values()]
+            .map((engine) => engine.descriptor)
+            .filter((descriptor) => descriptor.kind === kind && capabilities.every((capability) => descriptor.capabilities.includes(capability)));
+    }
+    list() {
+        return [...this.engines.values()].map((engine) => engine.descriptor);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM1C,MAAM,OAAO,cAAc;IACR,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAExD,QAAQ,CAAC,MAAiB;QACxB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,UAAU,CAAC,EAAE,yBAAyB,CAAC,CAAC;QACrH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAkC,EAAU,EAAE,IAAiB;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,WAAW,CAAC,oBAAoB,EAAE,MAAM,IAAI,IAAI,OAAO,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;QACzG,CAAC;QACD,OAAO,MAAW,CAAC;IACrB,CAAC;IAED,IAAI,CAAC,IAAgB,EAAE,eAA2C,EAAE;QAClE,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;aAC9B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;aAClC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC1I,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/core/types.d.ts

@@ -0,0 +1,141 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type EngineKind = "structured-model" | "tool-agent" | "coding-runtime";
+export type BuiltInCapability = "structured-output" | "streaming" | "tools" | "tool-approval" | "tool-filtering" | "sessions" | "resumable-sessions" | "local-workspace" | "read-only-workspace" | "workspace-write" | "skills" | "artifacts" | "citations";
+export type AgentCapability = BuiltInCapability | (string & {});
+export interface EngineDescriptor {
+    id: string;
+    name: string;
+    kind: EngineKind;
+    version?: string;
+    provider?: string;
+    model?: string;
+    capabilities: readonly AgentCapability[];
+}
+export interface SourceAnchor {
+    kind: "page" | "epub-cfi" | "text-range" | "line-range" | "custom";
+    value: string;
+    quote?: string;
+    metadata?: JsonObject;
+}
+export interface ContextArtifact {
+    id: string;
+    uri: string;
+    mediaType: string;
+    title?: string;
+    content?: string;
+    anchor?: SourceAnchor;
+    metadata?: JsonObject;
+}
+export interface Citation {
+    artifactId: string;
+    label: string;
+    anchor?: SourceAnchor;
+}
+export interface AgentMessage {
+    role: "system" | "user" | "assistant";
+    parts: readonly AgentContentPart[];
+    citations?: Citation[];
+    metadata?: JsonObject;
+}
+export type AgentContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "json";
+    value: JsonValue;
+} | {
+    type: "artifact";
+    artifactId: string;
+} | {
+    type: "file";
+    uri: string;
+    mediaType: string;
+    name?: string;
+} | {
+    type: "image";
+    uri: string;
+    mediaType?: string;
+    alt?: string;
+};
+export interface AgentInput {
+    prompt: string;
+    instructions?: string;
+    messages?: readonly AgentMessage[];
+    artifacts?: readonly ContextArtifact[];
+}
+/** Host-owned identity, limits, and correlation data required by every execution. */
+export interface RunContext {
+    runId?: string;
+    sessionId?: string;
+    abortSignal?: AbortSignal;
+    metadata?: JsonObject;
+    scope: ExecutionScope;
+    traceId?: string;
+    idempotencyKey?: string;
+    deadline?: string;
+    budget?: RunBudget;
+    credentialRef?: string;
+    engineOptions?: JsonObject;
+}
+/**
+ * Authority and isolation boundary for a run.
+ * Store implementations must isolate at least tenant, project, principal, and engagement.
+ */
+export interface ExecutionScope {
+    tenantId: string;
+    projectId: string;
+    principalId: string;
+    engagementId?: string;
+    roles: readonly string[];
+    permissions: readonly string[];
+    dataClassification: "public" | "internal" | "confidential" | "restricted";
+}
+/** Creates a wildcard-permission scope for genuinely single-user local applications. */
+export declare function localExecutionScope(projectId: string, principalId?: string): ExecutionScope;
+/** Validates the structural invariants required for execution isolation. */
+export declare function assertExecutionScope(scope: ExecutionScope): void;
+export declare function textMessage(role: AgentMessage["role"], text: string): AgentMessage;
+export interface RunBudget {
+    maxTokens?: number;
+    maxCostUsd?: number;
+    maxDurationMs?: number;
+}
+export interface TokenUsage {
+    input?: number;
+    output?: number;
+    total?: number;
+}
+/** Auditable identity of the adapter, provider/model, and runtime used for a run. */
+export interface RunProvenance {
+    engineId: string;
+    adapterStrategy: string;
+    provider?: string;
+    model?: string;
+    runtime?: string;
+    runtimeVersion?: string;
+}
+export type FailureCode = "authentication-required" | "cancelled" | "empty-response" | "engine-unavailable" | "invalid-json" | "invocation-failed" | "output-invalid" | "permission-denied" | "configuration-invalid" | "budget-exceeded" | "session-conflict" | "timeout" | "tool-failed" | "unsupported-capability";
+export interface SafeFailure {
+    code: FailureCode;
+    message: string;
+    retryable: boolean;
+    cause?: unknown;
+}
+/** Discovery and bounded-probe evidence for a local coding runtime. */
+export interface RuntimeReadiness {
+    runtimeId: string;
+    availability: "missing" | "installed" | "setup-required";
+    verification: "unverified" | "ready" | "failed" | "not-applicable";
+    version?: string;
+    checkedAt?: string;
+    durationMs?: number;
+    failure?: Omit<SafeFailure, "cause">;
+    detail: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACnF,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAC9E,MAAM,MAAM,iBAAiB,GACzB,mBAAmB,GACnB,WAAW,GACX,OAAO,GACP,eAAe,GACf,gBAAgB,GAChB,UAAU,GACV,oBAAoB,GACpB,iBAAiB,GACjB,qBAAqB,GACrB,iBAAiB,GACjB,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;AAChB,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACnC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACxC;AAED,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,UAAU,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,kBAAkB,EAAE,QAAQ,GAAG,UAAU,GAAG,cAAc,GAAG,YAAY,CAAC;CAC3E;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,SAAe,GAAG,cAAc,CAEjG;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAOhE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAElF;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GACnB,yBAAyB,GACzB,WAAW,GACX,gBAAgB,GAChB,oBAAoB,GACpB,cAAc,GACd,mBAAmB,GACnB,gBAAgB,GAChB,mBAAmB,GACnB,uBAAuB,GACvB,iBAAiB,GACjB,kBAAkB,GAClB,SAAS,GACT,aAAa,GACb,wBAAwB,CAAC;AAE7B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,SAAS,GAAG,WAAW,GAAG,gBAAgB,CAAC;IACzD,YAAY,EAAE,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/core/types.js

@@ -0,0 +1,21 @@
+/** Creates a wildcard-permission scope for genuinely single-user local applications. */
+export function localExecutionScope(projectId, principalId = "local-user") {
+    return { tenantId: "local", projectId, principalId, roles: ["owner"], permissions: ["*"], dataClassification: "internal" };
+}
+/** Validates the structural invariants required for execution isolation. */
+export function assertExecutionScope(scope) {
+    for (const [field, value] of [["tenantId", scope?.tenantId], ["projectId", scope?.projectId], ["principalId", scope?.principalId]]) {
+        if (typeof value !== "string" || !value.trim())
+            throw new Error(`Execution scope ${field} must be a non-empty string.`);
+    }
+    if (!Array.isArray(scope.roles) || !scope.roles.every((role) => typeof role === "string" && role.length > 0))
+        throw new Error("Execution scope roles must contain non-empty strings.");
+    if (!Array.isArray(scope.permissions) || !scope.permissions.every((permission) => typeof permission === "string" && permission.length > 0))
+        throw new Error("Execution scope permissions must contain non-empty strings.");
+    if (!["public", "internal", "confidential", "restricted"].includes(scope.dataClassification))
+        throw new Error("Execution scope dataClassification is invalid.");
+}
+export function textMessage(role, text) {
+    return { role, parts: [{ type: "text", text }] };
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAwGA,wFAAwF;AACxF,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,WAAW,GAAG,YAAY;IAC/E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAC7H,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACxD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,WAAW,CAAC,CAAU,EAAE,CAAC;QAC5I,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,8BAA8B,CAAC,CAAC;IAC1H,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACvL,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAC3N,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;AAClK,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAA0B,EAAE,IAAY;IAClE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACnD,CAAC"}

package/dist/core/version.d.ts

@@ -0,0 +1,3 @@
+/** The agent-v package version used by diagnostics and compatibility checks. */
+export declare const AGENT_V_VERSION = "0.4.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/core/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,eAAO,MAAM,eAAe,UAAU,CAAC"}

package/dist/core/version.js

@@ -0,0 +1,3 @@
+/** The agent-v package version used by diagnostics and compatibility checks. */
+export const AGENT_V_VERSION = "0.4.0";
+//# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC"}

package/dist/node/doctor.d.ts

@@ -0,0 +1,50 @@
+import { type RuntimeReadiness } from "../core/index.js";
+export interface DoctorDependency {
+    name: string;
+    installed: boolean;
+    version?: string;
+    purpose: string;
+}
+export interface DoctorOllamaReadiness {
+    availability: "ready" | "unreachable" | "setup-required" | "dependency-missing";
+    version?: string;
+    models: readonly string[];
+    detail: string;
+    failure?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+}
+export interface DoctorIssue {
+    severity: "info" | "warning" | "error";
+    component: string;
+    message: string;
+    remediation?: string;
+}
+export interface AgentVDoctorReport {
+    schemaVersion: 1;
+    packageVersion: string;
+    checkedAt: string;
+    dependencies: readonly DoctorDependency[];
+    runtimes: readonly RuntimeReadiness[];
+    ollama: DoctorOllamaReadiness;
+    issues: readonly DoctorIssue[];
+    ok: boolean;
+}
+export interface AgentVDoctorOptions {
+    runtimeIds?: readonly string[];
+    probe?: boolean;
+    ollamaBaseURL?: string;
+    ollamaModel?: string;
+}
+export interface AgentVDoctorServices {
+    packageVersion(name: string): Promise<string | undefined>;
+    inspectRuntime(runtimeId: string): Promise<RuntimeReadiness>;
+    probeRuntime(runtimeId: string): Promise<RuntimeReadiness>;
+    inspectOllama(options: {
+        baseURL?: string;
+    }): Promise<DoctorOllamaReadiness>;
+}
+export declare function doctorAgentV(options?: AgentVDoctorOptions, services?: AgentVDoctorServices): Promise<AgentVDoctorReport>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/node/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/node/doctor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,OAAO,GAAG,aAAa,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CACjE;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CAAC,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC1C,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1D,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7D,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3D,aAAa,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC9E;AA+CD,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB,EAAE,QAAQ,GAAE,oBAAwC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+DrJ"}

package/dist/node/doctor.js

@@ -0,0 +1,121 @@
+import { readFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { dirname, join, parse } from "node:path";
+import { LocalCliRuntimeEngine, builtInRuntimes, } from "../adapters/local-cli/index.js";
+import { AGENT_V_VERSION } from "../core/index.js";
+async function packageVersion(name) {
+    const require = createRequire(import.meta.url);
+    let current;
+    try {
+        current = dirname(require.resolve(name));
+    }
+    catch {
+        return undefined;
+    }
+    const root = parse(current).root;
+    while (current !== root) {
+        try {
+            const manifest = JSON.parse(await readFile(join(current, "package.json"), "utf8"));
+            if (manifest.name === name && typeof manifest.version === "string")
+                return manifest.version;
+        }
+        catch { /* Continue toward the filesystem root. */ }
+        current = dirname(current);
+    }
+    return undefined;
+}
+async function inspectOllama(options) {
+    try {
+        const adapter = await import("../adapters/ollama/index.js");
+        return adapter.inspectOllama(options);
+    }
+    catch (error) {
+        const missing = error instanceof Error && error.code === "ERR_MODULE_NOT_FOUND";
+        return {
+            availability: missing ? "dependency-missing" : "unreachable",
+            models: [],
+            detail: missing ? "The optional Ollama adapter dependencies are not installed." : "The Ollama adapter could not be loaded.",
+            failure: {
+                code: missing ? "dependency-missing" : "engine-unavailable",
+                message: missing ? "Install ai and ai-sdk-ollama to use @vraxis/agent-v/ollama." : "The Ollama adapter could not be loaded.",
+                retryable: false,
+            },
+        };
+    }
+}
+function defaultServices() {
+    const local = new LocalCliRuntimeEngine();
+    return {
+        packageVersion,
+        inspectRuntime: (runtimeId) => local.inspect(runtimeId),
+        probeRuntime: (runtimeId) => local.probe(runtimeId),
+        inspectOllama,
+    };
+}
+export async function doctorAgentV(options = {}, services = defaultServices()) {
+    if (options.probe && (!options.runtimeIds || options.runtimeIds.length === 0)) {
+        throw new Error("Live probing requires at least one explicit runtime id.");
+    }
+    const packageNames = ["@vraxis/agent-v", "ai", "ai-sdk-ollama"];
+    const purposes = {
+        "@vraxis/agent-v": "core execution contracts",
+        ai: "optional AI SDK adapter",
+        "ai-sdk-ollama": "optional Ollama adapter",
+    };
+    const dependencies = await Promise.all(packageNames.map(async (name) => {
+        const version = name === "@vraxis/agent-v" ? AGENT_V_VERSION : await services.packageVersion(name);
+        return { name, installed: Boolean(version), version, purpose: purposes[name] };
+    }));
+    const requestedRuntimes = options.runtimeIds ?? builtInRuntimes.map((runtime) => runtime.id);
+    const runtimes = await Promise.all(requestedRuntimes.map((id) => options.probe ? services.probeRuntime(id) : services.inspectRuntime(id)));
+    const ollama = await services.inspectOllama({ baseURL: options.ollamaBaseURL });
+    const issues = [];
+    for (const dependency of dependencies) {
+        if (dependency.name === "@vraxis/agent-v" && !dependency.installed) {
+            issues.push({ severity: "error", component: dependency.name, message: "The @vraxis/agent-v package is not resolvable." });
+        }
+        else if (!dependency.installed) {
+            issues.push({ severity: "info", component: dependency.name, message: `${dependency.name} is not installed because its adapter is optional.` });
+        }
+    }
+    for (const runtime of runtimes) {
+        const explicitlyRequested = options.runtimeIds?.includes(runtime.runtimeId) ?? false;
+        if (runtime.availability !== "installed") {
+            issues.push({
+                severity: explicitlyRequested ? "error" : "info",
+                component: runtime.runtimeId,
+                message: runtime.detail,
+                remediation: `Install and configure ${runtime.runtimeId}, or select another runtime.`,
+            });
+        }
+        else if (options.probe && runtime.verification !== "ready") {
+            issues.push({ severity: "error", component: runtime.runtimeId, message: runtime.detail, remediation: `Authenticate ${runtime.runtimeId} and rerun the bounded probe.` });
+        }
+        else if (!options.probe && runtime.verification !== "ready") {
+            issues.push({ severity: "info", component: runtime.runtimeId, message: `${runtime.detail} Use --probe with an explicit --runtime to verify authentication.` });
+        }
+    }
+    const ollamaRequested = Boolean(options.ollamaBaseURL || options.ollamaModel);
+    if (ollama.availability !== "ready") {
+        issues.push({
+            severity: ollamaRequested ? "error" : dependencies.find((dependency) => dependency.name === "ai-sdk-ollama")?.installed ? "warning" : "info",
+            component: "ollama",
+            message: ollama.detail,
+            remediation: ollama.availability === "dependency-missing" ? "Install ai and ai-sdk-ollama." : "Start or configure Ollama, then rerun doctor.",
+        });
+    }
+    else if (options.ollamaModel && !ollama.models.includes(options.ollamaModel)) {
+        issues.push({ severity: "error", component: "ollama", message: `Ollama model ${options.ollamaModel} is not installed.`, remediation: `Pull ${options.ollamaModel} only if that model is intentionally selected.` });
+    }
+    return {
+        schemaVersion: 1,
+        packageVersion: AGENT_V_VERSION,
+        checkedAt: new Date().toISOString(),
+        dependencies,
+        runtimes,
+        ollama,
+        issues,
+        ok: !issues.some((issue) => issue.severity === "error"),
+    };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/node/doctor.js.map

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

package/dist/node/index.d.ts

@@ -0,0 +1,26 @@
+import { type AgentEvent, type AgentSession, type AgentVConfig, type ConfigStore, type EventSink, type ExecutionScope, type RunEventStore, type SessionStore } from "../core/index.js";
+export * from "./skills.js";
+export * from "./doctor.js";
+export declare class JsonConfigStore implements ConfigStore {
+    private readonly path;
+    constructor(path: string);
+    load(): Promise<AgentVConfig>;
+    save(config: AgentVConfig): Promise<void>;
+}
+export declare class JsonSessionStore implements SessionStore {
+    private readonly directory;
+    constructor(directory: string);
+    private path;
+    get(scope: ExecutionScope, id: string): Promise<AgentSession | undefined>;
+    save(session: AgentSession): Promise<void>;
+    delete(scope: ExecutionScope, id: string): Promise<void>;
+}
+export declare class JsonlRunEventStore implements RunEventStore, EventSink {
+    private readonly path;
+    private pending;
+    constructor(path: string);
+    append(event: AgentEvent): Promise<void>;
+    emit(event: AgentEvent): Promise<void>;
+    list(scope: ExecutionScope, runId: string): Promise<readonly AgentEvent[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEtM,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAc5B,qBAAa,eAAgB,YAAW,WAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IACnC,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC;IAC7B,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAChD;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAC9C,OAAO,CAAC,IAAI;IAMN,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IACzE,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI/D;AAED,qBAAa,kBAAmB,YAAW,aAAa,EAAE,SAAS;IAErD,OAAO,CAAC,QAAQ,CAAC,IAAI;IADjC,OAAO,CAAC,OAAO,CAAoC;gBACtB,IAAI,EAAE,MAAM;IACzC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;CAajF"}

package/dist/node/index.js

@@ -0,0 +1,84 @@
+import { mkdir, readFile, rename, writeFile, appendFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { defaultConfig } from "../core/index.js";
+export * from "./skills.js";
+export * from "./doctor.js";
+async function atomicJson(path, value) {
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const temporary = `${path}.${process.pid}.${crypto.randomUUID()}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600 });
+    await rename(temporary, path);
+}
+async function readJson(path) {
+    try {
+        return JSON.parse(await readFile(path, "utf8"));
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+export class JsonConfigStore {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    async load() { return (await readJson(this.path)) ?? defaultConfig(); }
+    async save(config) { await atomicJson(this.path, config); }
+}
+export class JsonSessionStore {
+    directory;
+    constructor(directory) {
+        this.directory = directory;
+    }
+    path(scope, id) {
+        for (const [label, value] of [["tenant", scope.tenantId], ["project", scope.projectId], ["principal", scope.principalId], ["engagement", scope.engagementId ?? "none"], ["session", id]]) {
+            if (!/^[a-zA-Z0-9_-]+$/.test(value))
+                throw new Error(`${label} ids may contain only letters, numbers, underscores, and hyphens.`);
+        }
+        return `${this.directory}/${scope.tenantId}/${scope.projectId}/${scope.principalId}/${scope.engagementId ?? "none"}/${id}.json`;
+    }
+    async get(scope, id) { return readJson(this.path(scope, id)); }
+    async save(session) { await atomicJson(this.path(session.scope, session.id), session); }
+    async delete(scope, id) {
+        const { rm } = await import("node:fs/promises");
+        await rm(this.path(scope, id), { force: true });
+    }
+}
+export class JsonlRunEventStore {
+    path;
+    pending = Promise.resolve();
+    constructor(path) {
+        this.path = path;
+    }
+    append(event) {
+        const write = this.pending.then(async () => {
+            await mkdir(dirname(this.path), { recursive: true, mode: 0o700 });
+            await appendFile(this.path, `${JSON.stringify(event)}\n`, { mode: 0o600 });
+        });
+        this.pending = write.catch(() => undefined);
+        return write;
+    }
+    emit(event) { return this.append(event); }
+    async list(scope, runId) {
+        const contents = await readFile(this.path, "utf8").catch((error) => {
+            if (error.code === "ENOENT")
+                return "";
+            throw error;
+        });
+        return contents.split("\n").filter(Boolean).flatMap((line) => {
+            try {
+                return [JSON.parse(line)];
+            }
+            catch {
+                return [];
+            }
+        }).filter((event) => event.runId === runId
+            && event.scope.tenantId === scope.tenantId
+            && event.scope.projectId === scope.projectId
+            && event.scope.principalId === scope.principalId
+            && event.scope.engagementId === scope.engagementId);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

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

package/dist/node/skills.d.ts

@@ -0,0 +1,12 @@
+import { type AgentSkill } from "../core/index.js";
+export interface LoadedSkillPackage {
+    skill: AgentSkill;
+    rootPath: string;
+    manifestPath: string;
+    scripts: readonly string[];
+    references: readonly string[];
+    assets: readonly string[];
+}
+export declare function loadSkillPackage(directory: string): Promise<LoadedSkillPackage>;
+export declare function discoverSkillPackages(parentDirectory: string): Promise<readonly LoadedSkillPackage[]>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/node/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/node/skills.ts"],"names":[],"mappings":"AAIA,OAAO,EAAe,KAAK,UAAU,EAAmB,MAAM,kBAAkB,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAuCD,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+CrF;AAED,wBAAsB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAI3G"}