@farmslot/protocol 0.5.0

package/dist/step-io.d.ts

@@ -0,0 +1,277 @@
+export interface SubStepRecord {
+    name: string;
+    outcome: 'ok' | 'skipped' | 'failed';
+    durationMs: number;
+    detail?: string;
+}
+export declare const RECIPE_ARTIFACT_TYPES: readonly ["screenshot", "video", "log", "trace", "summary", "json", "report", "metric", "diff", "recipe", "other"];
+export type RecipeArtifactType = (typeof RECIPE_ARTIFACT_TYPES)[number];
+export type RecipeArtifactTypeName = RecipeArtifactType | (string & {});
+export interface RecipeArtifactManifestEntry {
+    path: string;
+    type: RecipeArtifactTypeName;
+    label?: string;
+    nodeId?: string;
+    mimeType?: string;
+    category?: 'proof' | 'debug' | 'diagnostic' | 'system' | (string & {});
+    proofTarget?: string;
+    covers?: string[];
+}
+export interface RecipeArtifactManifestDocument {
+    version: 1;
+    runStatus?: 'pass' | 'fail' | 'unknown';
+    artifacts: RecipeArtifactManifestEntry[];
+}
+export interface ArtifactRef {
+    path: string;
+    purpose: string;
+    sha256?: string;
+    sizeBytes?: number;
+    type?: RecipeArtifactTypeName;
+    label?: string;
+    nodeId?: string;
+    mimeType?: string;
+}
+export declare function isPublishEvidenceArtifact(artifact: Pick<ArtifactRef, 'path' | 'purpose'>): boolean;
+export interface MonitorSnapshot {
+    timestamp: string;
+    trigger: 'violation' | 'phase-transition' | 'decision' | 'nudge';
+    violation?: {
+        type: string;
+        message: string;
+    };
+    taskProgress?: {
+        completedSteps: number;
+        totalSteps: number;
+        currentPhase: string;
+    };
+}
+/** Per-step LLM usage — every HEU step output includes this.
+ *  Enables per-step cost tracking and model comparison across runs.
+ *  Populated by callLLM() wrapper when it exists; manual until then. */
+export interface StepLLMUsage {
+    provider: string;
+    model: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+    durationMs: number;
+}
+export interface GradeStepInput {
+    ticketOrPr: string;
+    ticketSource?: string;
+}
+export interface GradeStepOutput {
+    difficulty?: string;
+    score?: number;
+    modelRecommendation?: string;
+    rationale?: string;
+    source?: string;
+    title?: string;
+    flowTypeMismatch?: string | null;
+    llm?: StepLLMUsage;
+    summary?: string;
+    branchSlug?: string;
+    summaryLlm?: StepLLMUsage;
+}
+export interface FindSlotStepInput {
+    project: string;
+    flowType: string;
+    requestedSlotId?: string;
+}
+export interface SlotCandidate {
+    slotId: string;
+    score: number;
+    cdpLive: boolean;
+}
+export interface FindSlotStepOutput {
+    selectedSlot: string;
+    runner: string;
+    model: string;
+    selectionMethod: 'user-specified' | 'affinity' | 'scored';
+    candidateCount: number;
+    candidates: SlotCandidate[];
+}
+export interface WriteTaskStepInput {
+    flowType: string;
+    hasTicketData: boolean;
+}
+export interface WriteTaskStepOutput {
+    taskFile: string;
+    skipped?: boolean;
+    collision?: boolean;
+    templateName?: string;
+    taskRelDir?: string;
+    branch?: string;
+    artifacts?: ArtifactRef[];
+    variableCount?: number;
+    llm?: StepLLMUsage;
+    summary?: string;
+    branchSlug?: string;
+    recipeStrategy?: import('./types.js').RecipeStrategyDecision;
+    subSteps?: SubStepRecord[];
+}
+export interface PrepareStepInput {
+    slotId: string;
+    branch?: string;
+    mergeMain: boolean;
+    flowType: string;
+}
+export interface PrepareStepOutput {
+    success: boolean;
+    subSteps: SubStepRecord[];
+    machine?: string;
+    platform?: string;
+    isLocal?: boolean;
+    healthValue?: string;
+    cliCommand?: string;
+}
+export interface DispatchStepInput {
+    slotId: string;
+    runner?: string;
+    model?: string;
+    taskFile: string;
+}
+export interface DispatchStepOutput {
+    success: boolean;
+    subSteps: SubStepRecord[];
+    launchCommand?: string;
+    readinessWaitMs?: number;
+    promptSent?: boolean;
+    cliCommand?: string;
+}
+export interface MonitorStepInput {
+    slotId: string;
+    pollIntervalMs?: number;
+    stuckTimeoutMs?: number;
+    idleTimeoutMs?: number;
+    totalTimeoutMs?: number;
+    maxNudges?: number;
+}
+export interface MonitorStepOutput {
+    nudgeCount: number;
+    pollCount: number;
+    exitReason: 'worker-done' | 'cancelled' | 'timeout' | 'aborted' | 'error';
+    violations: Array<{
+        type: string;
+        message: string;
+        timestamp: string;
+    }>;
+    snapshots: MonitorSnapshot[];
+    finalTaskProgress?: {
+        completedSteps: number;
+        totalSteps: number;
+    };
+    cliCommand?: string;
+}
+export interface SelfReviewStepInput {
+    slotId: string;
+    enabled: boolean;
+    model?: string;
+}
+export interface SelfReviewIssue {
+    file: string;
+    line?: number;
+    description: string;
+}
+export interface SelfReviewStepOutput {
+    skipped?: boolean;
+    reason?: string;
+    verdict?: 'pass' | 'issues';
+    issues?: SelfReviewIssue[];
+    retryCount?: number;
+    feedbackSent?: boolean;
+    durationMs?: number;
+    cliCommand?: string;
+}
+export interface HumanGateStepInput {
+    gateType: string;
+    gateEnabled: boolean;
+}
+export interface HumanGateStepOutput {
+    skipped?: boolean;
+    reason?: string;
+    waitDurationMs?: number;
+    resolvedAction?: string | null;
+    gatePayloadSummary?: string;
+    artifacts?: ArtifactRef[];
+}
+export interface CompleteStepInput {
+    slotId: string;
+    flowType: string;
+}
+export interface CompleteStepOutput {
+    prNumber: number | null;
+    ciRepo: string | null;
+    artifactsCopied: boolean;
+    prCommentPosted: boolean;
+    prTitleUpdated: boolean;
+    prMarkedReady: boolean;
+    retrospectiveCreated: boolean;
+    slotDisposition: 'ci-watch' | 'released';
+    artifacts: ArtifactRef[];
+    cliCommand?: string;
+}
+export interface FinalizeStepInput {
+    slotId: string;
+    flowType: string;
+}
+export interface SessionMetrics {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    costUsd: number;
+    model: string;
+    sessionDurationMs: number;
+    numCompactions?: number;
+    numTurns?: number;
+}
+export interface FinalizeStepOutput {
+    session?: SessionMetrics;
+    commentPosted: boolean;
+    metricsSavedToTask: boolean;
+    artifactPath?: string;
+    cliCommand?: string;
+}
+export interface CIWatchStepInput {
+    prNumber?: number;
+}
+export type CIWatchPhase = 'polling' | 'deduped' | 'fixing' | 'waiting_for_worker' | 'blocked' | 'decision_required' | 'done';
+export type CIWatchFixTrigger = 'failed_checks' | 'bot_comments' | null;
+export interface CIWatchFixProgress {
+    completed: number;
+    total: number;
+    currentLabel?: string | null;
+}
+export interface CIWatchStepOutput {
+    skipped?: boolean;
+    reason?: string;
+    result?: string;
+    failedChecks?: string[];
+    phase?: CIWatchPhase;
+    fixInProgress?: boolean;
+    fixTrigger?: CIWatchFixTrigger;
+    activeTaskFile?: string | null;
+    nextPollAt?: string | null;
+    lastSignalAt?: string | null;
+    dedupReason?: string | null;
+    lastFixCommitSha?: string | null;
+    fixProgress?: CIWatchFixProgress;
+    timeoutWindowStartedAt?: string;
+    lastProgressAt?: string;
+    lastProgressReason?: string;
+    pollCount: number;
+    pollIntervalMs?: number;
+    lastCheckedAt?: string;
+    totalDurationMs: number;
+    checkTimeline: Array<{
+        timestamp: string;
+        status: string;
+        detail?: string;
+    }>;
+    actionableBotCommentCount: number;
+    cliCommand?: string;
+}
+//# sourceMappingURL=step-io.d.ts.map

package/dist/step-io.d.ts.map

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

package/dist/step-io.js

@@ -0,0 +1,26 @@
+// step-io.ts — Typed step I/O and shared recipe artifact interfaces
+// Phase 1 of the Step I/O Refactor (prerequisite for C3 fine-tuning export).
+// RunStep.inputs/outputs remains Record<string, unknown> for backward compat.
+// These interfaces are used by step executors and consumers via typed casts.
+// ─── Recipe Artifact Manifest ───
+export const RECIPE_ARTIFACT_TYPES = [
+    'screenshot',
+    'video',
+    'log',
+    'trace',
+    'summary',
+    'json',
+    'report',
+    'metric',
+    'diff',
+    'recipe',
+    'other',
+];
+const PUBLISH_EVIDENCE_MEDIA_EXTS = /\.(png|jpg|jpeg|gif|mp4|mov|webm)$/i;
+export function isPublishEvidenceArtifact(artifact) {
+    const normalizedPath = artifact.path.replace(/\\/g, '/').toLowerCase();
+    return (PUBLISH_EVIDENCE_MEDIA_EXTS.test(artifact.path) &&
+        artifact.purpose?.toLowerCase() !== 'debug-screenshot' &&
+        !/(^|\/)screenshots\//.test(normalizedPath));
+}
+//# sourceMappingURL=step-io.js.map

package/dist/step-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-io.js","sourceRoot":"","sources":["../src/step-io.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,6EAA6E;AAC7E,8EAA8E;AAC9E,6EAA6E;AAW7E,mCAAmC;AAEnC,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,YAAY;IACZ,OAAO;IACP,KAAK;IACL,OAAO;IACP,SAAS;IACT,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,OAAO;CACC,CAAC;AAmCX,MAAM,2BAA2B,GAAG,qCAAqC,CAAC;AAE1E,MAAM,UAAU,yBAAyB,CACvC,QAA+C;IAE/C,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACvE,OAAO,CACL,2BAA2B,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC/C,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB;QACtD,CAAC,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC,CAC5C,CAAC;AACJ,CAAC"}

package/dist/surfaces.d.ts

@@ -0,0 +1,36 @@
+import type { ChatClientContext } from './types.js';
+export interface CommandCenterSurfaceDefinition {
+    surfaceId: string;
+    routePattern: string;
+    routeRegex: string;
+    routeParamNames: string[];
+    queryParams: string[];
+    componentPath: string;
+    componentSymbol: string;
+    primaryEntities: string[];
+    affordances: string[];
+    preferredTools: string[];
+    sourceAnchors: string[];
+    sampleHash: string;
+}
+export interface CommandCenterSurfaceMatch {
+    surface: CommandCenterSurfaceDefinition;
+    route: string;
+    hash: string;
+    query: Record<string, string>;
+    routeParams: Record<string, string>;
+    context: Partial<ChatClientContext>;
+}
+export declare const COMMAND_CENTER_SURFACES: CommandCenterSurfaceDefinition[];
+export declare function parseCommandCenterHash(hashValue: string): {
+    hash: string;
+    route: string;
+    query: Record<string, string>;
+};
+export declare function matchCommandCenterSurface(hashValue: string): CommandCenterSurfaceMatch | null;
+export declare function buildCommandCenterContext(hashValue: string): ChatClientContext;
+/** Co-Pilot's single shared session id. One chat per browser; screen context
+ *  rides every message via clientContext so route changes never fork it. */
+export declare const GLOBAL_CHAT_SESSION_ID = "global";
+export declare function deriveChatSessionId(_context: ChatClientContext): string;
+//# sourceMappingURL=surfaces.d.ts.map

package/dist/surfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../src/surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,8BAA8B,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACrC;AAED,eAAO,MAAM,uBAAuB,EAAE,8BAA8B,EA8SnE,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B,CASA;AAqCD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CAoB7F;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAe9E;AAED;4EAC4E;AAC5E,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAE/C,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAEvE"}