@moda-ai/cli 1.1.1 → 1.3.0

package/dist/harness.d.ts

@@ -0,0 +1,233 @@
+import type { CommandContext } from './command-context.js';
+declare const SCHEMA_VERSION = "harness.v0.1";
+export interface HarnessEvidence {
+    path: string;
+    reason: string;
+}
+export interface HarnessDetection {
+    confidence: number;
+    evidence: HarnessEvidence[];
+}
+export interface HarnessRepo {
+    root: string;
+    name: string;
+    packageManagers: string[];
+    languages: string[];
+    remoteHash?: string;
+}
+export interface HarnessScanMetadata {
+    createdAt: string;
+    scannerVersion: string;
+    mode: 'permissioned' | 'dry-run';
+    rootPaths: string[];
+    readPlan: HarnessScanReadPlan;
+    skipped: Array<{
+        path: string;
+        reason: string;
+    }>;
+}
+export interface HarnessScanReadPlan {
+    scope: 'broad' | 'narrow';
+    rootPaths: string[];
+    willRead: string[];
+    willSkip: string[];
+    skipsSecretFiles: boolean;
+    followsSymlinks: boolean;
+    uploadsSourceByDefault: boolean;
+}
+export interface HarnessTenantContext {
+    tenantId: string;
+    source: 'flag' | 'env_or_config' | 'scan_option';
+}
+export interface HarnessAgentFamily extends HarnessDetection {
+    id: string;
+    name: string;
+    description?: string;
+    runtimeAgentIds: string[];
+    sharedArtifactIds: string[];
+}
+export interface HarnessRuntimeAgent extends HarnessDetection {
+    id: string;
+    name: string;
+    kind: 'runtime_agent';
+    purpose?: string;
+    familyId?: string;
+    root: string;
+    entrypointIds: string[];
+    channelAdapterIds: string[];
+    artifactIds: string[];
+    identityNamespaceIds: string[];
+    deploymentIds: string[];
+    frameworkIds: string[];
+    modelProviderIds: string[];
+}
+export interface HarnessDeveloperAgentAdapter extends HarnessDetection {
+    id: string;
+    name: string;
+    kind: 'developer_agent_adapter';
+    sourcePath: string;
+}
+export interface HarnessChannelAdapter extends HarnessDetection {
+    id: string;
+    name: string;
+    kind: string;
+    sourcePath?: string;
+}
+export type HarnessArtifactType = 'entrypoint' | 'prompt' | 'tool' | 'skill' | 'eval' | 'retrieval_index' | 'memory' | 'guardrail' | 'model_config' | 'unknown';
+export interface HarnessArtifact extends HarnessDetection {
+    id: string;
+    type: HarnessArtifactType;
+    name: string;
+    scope: 'agent' | 'shared' | 'global';
+    sourcePath?: string;
+    contentHash?: string;
+    ownedByAgentId?: string;
+    usedByAgentIds: string[];
+}
+export interface HarnessIdentityNamespace extends HarnessDetection {
+    id: string;
+    name: string;
+    kind: string;
+    canonicalId?: string;
+    sourcePath?: string;
+}
+export interface HarnessEnvironment extends HarnessDetection {
+    id: string;
+    name: string;
+    kind: string;
+    sourcePath?: string;
+}
+export interface HarnessAgentFramework extends HarnessDetection {
+    id: string;
+    name: string;
+    kind: string;
+    packageNames: string[];
+    runtimeAgentIds: string[];
+}
+export interface HarnessModelProvider extends HarnessDetection {
+    id: string;
+    name: string;
+    kind: string;
+    packageNames: string[];
+    runtimeAgentIds: string[];
+    envVars: string[];
+    modelHints: string[];
+}
+export interface HarnessDeployment extends HarnessDetection {
+    id: string;
+    name: string;
+    environmentId?: string;
+    sourcePath?: string;
+}
+export interface HarnessRelationship {
+    type: 'uses_artifact' | 'owns_artifact' | 'shares_artifact_with' | 'invoked_by_channel' | 'deployed_as' | 'runs_in_environment' | 'resolves_identity_to' | 'covered_by_eval' | 'emits_telemetry';
+    from: string;
+    to: string;
+    artifactId?: string;
+    evidence: HarnessEvidence[];
+}
+export interface HarnessUnknown {
+    id: string;
+    question: string;
+    candidateIds: string[];
+    evidence: HarnessEvidence[];
+}
+export interface HarnessGraph {
+    schemaVersion: typeof SCHEMA_VERSION;
+    harnessId: string;
+    tenant?: HarnessTenantContext;
+    repo: HarnessRepo;
+    scan: HarnessScanMetadata;
+    agentFamilies: HarnessAgentFamily[];
+    runtimeAgents: HarnessRuntimeAgent[];
+    developerAgentAdapters: HarnessDeveloperAgentAdapter[];
+    channelAdapters: HarnessChannelAdapter[];
+    artifacts: HarnessArtifact[];
+    identityNamespaces: HarnessIdentityNamespace[];
+    environments: HarnessEnvironment[];
+    agentFrameworks: HarnessAgentFramework[];
+    modelProviders: HarnessModelProvider[];
+    deployments: HarnessDeployment[];
+    relationships: HarnessRelationship[];
+    unknowns: HarnessUnknown[];
+}
+interface ScanOptions {
+    rootDir?: string;
+    dryRun?: boolean;
+    scannerVersion?: string;
+    tenantId?: string;
+    tenantSource?: HarnessTenantContext['source'];
+    pathWasExplicit?: boolean;
+}
+export interface HarnessSummary {
+    schemaVersion: string;
+    harnessId: string;
+    tenantId?: string;
+    runtimeAgentCount: number;
+    agentFamilyCount: number;
+    sharedArtifactCount: number;
+    channelAdapterCount: number;
+    identityNamespaceCount: number;
+    agentFrameworkCount: number;
+    modelProviderCount: number;
+    deploymentCount: number;
+    unknownCount: number;
+}
+interface HarnessSyncResponse {
+    tenantId: string;
+    harnessId: string;
+    harnessKey: string;
+    versionId: string;
+    graphHash: string;
+    changed: boolean;
+    dryRun: boolean;
+    reportHash?: string | null;
+    reportValidationStatus?: string | null;
+    counts: Record<string, number>;
+}
+interface HarnessSyncPlan {
+    endpoint: '/api/harnesses/sync';
+    resource: 'harness';
+    source: 'local_scan' | 'approved_report';
+    profile: string;
+    tenantId?: string;
+    rootPath: string;
+    sourceCommit?: string;
+    harnessId: string;
+    localGraphHash: string;
+    counts: Record<string, number>;
+    uploads: string[];
+    localWrites: string[];
+    privacy: string[];
+}
+export interface HarnessSyncState {
+    schemaVersion: 'sync_state.v0.1';
+    updatedAt: string;
+    resource: 'harness';
+    source: HarnessSyncPlan['source'];
+    profile: string;
+    tenantId?: string;
+    rootPath: string;
+    sourceCommit?: string;
+    harnessId: string;
+    localGraphHash: string;
+    report?: {
+        reportId: string;
+        reportHash: string;
+        validationStatus: string;
+    };
+    remote: HarnessSyncResponse;
+    summary: HarnessSummary;
+    uploads: string[];
+    privacy: string[];
+    written: string[];
+}
+export declare function runHarnessCommand(context: CommandContext): Promise<{
+    exitCode: number;
+}>;
+export declare function scanHarness(options?: ScanOptions): HarnessGraph;
+export declare function summarizeHarness(graph: HarnessGraph): HarnessSummary;
+export declare function readHarnessSyncState(rootDir: string): HarnessSyncState | undefined;
+export declare function graphForSync(graph: HarnessGraph): HarnessGraph;
+export {};
+//# sourceMappingURL=harness.d.ts.map