@contractspec/example.agent-console 3.8.8 → 3.8.10

package/dist/node/run/run.operation.js

@@ -1,667 +1 @@
-// src/run/run.enum.ts
-import { defineEnum } from "@contractspec/lib.schema";
-var RunStatusEnum = defineEnum("RunStatus", [
-  "QUEUED",
-  "IN_PROGRESS",
-  "COMPLETED",
-  "FAILED",
-  "CANCELLED",
-  "EXPIRED"
-]);
-var RunStepTypeEnum = defineEnum("RunStepType", [
-  "MESSAGE_CREATION",
-  "TOOL_CALL",
-  "TOOL_RESULT",
-  "ERROR"
-]);
-var LogLevelEnum = defineEnum("LogLevel", [
-  "DEBUG",
-  "INFO",
-  "WARN",
-  "ERROR"
-]);
-var GranularityEnum = defineEnum("Granularity", [
-  "hour",
-  "day",
-  "week",
-  "month"
-]);
-
-// src/run/run.schema.ts
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var RunInputModel = defineSchemaModel({
-  name: "RunInput",
-  description: "Input data for agent execution",
-  fields: {
-    message: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    context: { type: ScalarTypeEnum.JSONObject(), isOptional: true }
-  }
-});
-var RunStepModel = defineSchemaModel({
-  name: "RunStep",
-  description: "Individual step within a run",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    stepNumber: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    type: { type: RunStepTypeEnum, isOptional: false },
-    toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    toolName: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    input: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    status: { type: RunStatusEnum, isOptional: false },
-    errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    tokensUsed: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 0
-    },
-    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
-  }
-});
-var RunLogModel = defineSchemaModel({
-  name: "RunLog",
-  description: "Execution log entry",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    stepId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    level: { type: LogLevelEnum, isOptional: false },
-    message: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    data: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    source: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    spanId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var RunAgentRefModel = defineSchemaModel({
-  name: "RunAgentRef",
-  description: "Agent reference in a run",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    modelProvider: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    modelName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var RunModel = defineSchemaModel({
-  name: "Run",
-  description: "Agent execution instance",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    organizationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    sessionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    input: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
-    output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    status: { type: RunStatusEnum, isOptional: false },
-    errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    errorCode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    totalTokens: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 0
-    },
-    promptTokens: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 0
-    },
-    completionTokens: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 0
-    },
-    totalIterations: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 0
-    },
-    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    estimatedCostUsd: {
-      type: ScalarTypeEnum.Float_unsecure(),
-      isOptional: true
-    },
-    queuedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    metadata: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    steps: { type: RunStepModel, isArray: true, isOptional: true },
-    logs: { type: RunLogModel, isArray: true, isOptional: true },
-    agent: { type: RunAgentRefModel, isOptional: true }
-  }
-});
-var RunSummaryModel = defineSchemaModel({
-  name: "RunSummary",
-  description: "Summary of a run for list views",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    agentName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    status: { type: RunStatusEnum, isOptional: false },
-    totalTokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    estimatedCostUsd: {
-      type: ScalarTypeEnum.Float_unsecure(),
-      isOptional: true
-    },
-    queuedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
-  }
-});
-var TimelineDataPointModel = defineSchemaModel({
-  name: "TimelineDataPoint",
-  description: "Timeline data point for metrics",
-  fields: {
-    period: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    runs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    tokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    costUsd: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
-    avgDurationMs: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false }
-  }
-});
-
-// src/run/run.operation.ts
-import {
-  defineCommand,
-  defineQuery
-} from "@contractspec/lib.contracts-spec/operations";
-import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
-var OWNERS = ["@agent-console-team"];
-var ExecuteAgentCommand = defineCommand({
-  meta: {
-    key: "agent.run.execute",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["run", "execute"],
-    description: "Starts a new agent run with the given input.",
-    goal: "Execute an AI agent with user input.",
-    context: "Called from chat interface or API."
-  },
-  io: {
-    input: defineSchemaModel2({
-      name: "ExecuteAgentInput",
-      fields: {
-        agentId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-        input: { type: RunInputModel, isOptional: false },
-        sessionId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-        metadata: { type: ScalarTypeEnum2.JSONObject(), isOptional: true },
-        stream: { type: ScalarTypeEnum2.Boolean(), isOptional: true },
-        maxIterations: {
-          type: ScalarTypeEnum2.Int_unsecure(),
-          isOptional: true
-        },
-        timeoutMs: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: true }
-      }
-    }),
-    output: defineSchemaModel2({
-      name: "ExecuteAgentOutput",
-      fields: {
-        runId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-        status: { type: RunStatusEnum, isOptional: false },
-        estimatedWaitMs: {
-          type: ScalarTypeEnum2.Int_unsecure(),
-          isOptional: true
-        }
-      }
-    }),
-    errors: {
-      AGENT_NOT_FOUND: {
-        description: "The specified agent does not exist",
-        http: 404,
-        gqlCode: "AGENT_NOT_FOUND",
-        when: "Agent ID is invalid"
-      },
-      AGENT_NOT_ACTIVE: {
-        description: "The specified agent is not active",
-        http: 400,
-        gqlCode: "AGENT_NOT_ACTIVE",
-        when: "Agent is in draft/paused/archived state"
-      }
-    }
-  },
-  policy: { auth: "user" },
-  sideEffects: {
-    emits: [
-      {
-        key: "run.started",
-        version: "1.0.0",
-        stability: "stable",
-        owners: [...OWNERS],
-        tags: ["run", "started"],
-        when: "Run is queued",
-        payload: RunSummaryModel
-      }
-    ],
-    audit: ["run.started"]
-  },
-  acceptance: {
-    scenarios: [
-      {
-        key: "execute-agent-happy-path",
-        given: ["Agent exists", "Agent is active"],
-        when: ["User submits execution request"],
-        then: ["Run is created", "RunStarted event is emitted"]
-      },
-      {
-        key: "execute-agent-not-active",
-        given: ["Agent exists but is not active"],
-        when: ["User attempts to execute"],
-        then: ["AGENT_NOT_ACTIVE error is returned"]
-      }
-    ],
-    examples: [
-      {
-        key: "basic-execute",
-        input: { agentId: "agent-123", input: { message: "Hello" } },
-        output: { runId: "run-456", status: "pending", estimatedWaitMs: 5000 }
-      }
-    ]
-  }
-});
-var CancelRunCommand = defineCommand({
-  meta: {
-    key: "agent.run.cancel",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["run", "cancel"],
-    description: "Cancels an in-progress agent run.",
-    goal: "Stop a running agent execution.",
-    context: "Called when user wants to abort a long-running task."
-  },
-  io: {
-    input: defineSchemaModel2({
-      name: "CancelRunInput",
-      fields: {
-        runId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-        reason: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true }
-      }
-    }),
-    output: defineSchemaModel2({
-      name: "CancelRunOutput",
-      fields: {
-        success: { type: ScalarTypeEnum2.Boolean(), isOptional: false },
-        status: { type: RunStatusEnum, isOptional: false }
-      }
-    }),
-    errors: {
-      RUN_NOT_FOUND: {
-        description: "The specified run does not exist",
-        http: 404,
-        gqlCode: "RUN_NOT_FOUND",
-        when: "Run ID is invalid"
-      },
-      RUN_NOT_CANCELLABLE: {
-        description: "The run cannot be cancelled",
-        http: 400,
-        gqlCode: "RUN_NOT_CANCELLABLE",
-        when: "Run is already completed/failed/cancelled"
-      }
-    }
-  },
-  policy: { auth: "user" },
-  sideEffects: {
-    emits: [
-      {
-        key: "run.cancelled",
-        version: "1.0.0",
-        stability: "stable",
-        owners: [...OWNERS],
-        tags: ["run", "cancelled"],
-        when: "Run is cancelled",
-        payload: RunSummaryModel
-      }
-    ],
-    audit: ["run.cancelled"]
-  },
-  acceptance: {
-    scenarios: [
-      {
-        key: "cancel-run-happy-path",
-        given: ["Run exists", "Run is in progress"],
-        when: ["User cancels run"],
-        then: ["Run is cancelled", "RunCancelled event is emitted"]
-      },
-      {
-        key: "cancel-run-already-completed",
-        given: ["Run exists but is already completed"],
-        when: ["User attempts to cancel"],
-        then: ["RUN_NOT_CANCELLABLE error is returned"]
-      }
-    ],
-    examples: [
-      {
-        key: "cancel-basic",
-        input: { runId: "run-456", reason: "User requested" },
-        output: { success: true, status: "cancelled" }
-      }
-    ]
-  }
-});
-var GetRunQuery = defineQuery({
-  meta: {
-    key: "agent.run.get",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["run", "get"],
-    description: "Retrieves a run by its ID with optional details.",
-    goal: "View detailed run information.",
-    context: "Run details page or monitoring."
-  },
-  io: {
-    input: defineSchemaModel2({
-      name: "GetRunInput",
-      fields: {
-        runId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-        includeSteps: { type: ScalarTypeEnum2.Boolean(), isOptional: true },
-        includeLogs: { type: ScalarTypeEnum2.Boolean(), isOptional: true }
-      }
-    }),
-    output: RunModel,
-    errors: {
-      RUN_NOT_FOUND: {
-        description: "The specified run does not exist",
-        http: 404,
-        gqlCode: "RUN_NOT_FOUND",
-        when: "Run ID is invalid"
-      }
-    }
-  },
-  policy: { auth: "user" },
-  acceptance: {
-    scenarios: [
-      {
-        key: "get-run-happy-path",
-        given: ["Run exists"],
-        when: ["User requests run by ID"],
-        then: ["Run details are returned"]
-      }
-    ],
-    examples: [
-      {
-        key: "get-with-steps",
-        input: { runId: "run-456", includeSteps: true, includeLogs: false },
-        output: { id: "run-456", status: "completed", steps: [] }
-      }
-    ]
-  }
-});
-var ListRunsQuery = defineQuery({
-  meta: {
-    key: "agent.run.list",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["run", "list"],
-    description: "Lists runs with optional filtering.",
-    goal: "Browse and search run history.",
-    context: "Run history/dashboard view."
-  },
-  io: {
-    input: defineSchemaModel2({
-      name: "ListRunsInput",
-      fields: {
-        organizationId: {
-          type: ScalarTypeEnum2.String_unsecure(),
-          isOptional: true
-        },
-        agentId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-        userId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-        sessionId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-        status: { type: RunStatusEnum, isOptional: true },
-        startDate: { type: ScalarTypeEnum2.DateTime(), isOptional: true },
-        endDate: { type: ScalarTypeEnum2.DateTime(), isOptional: true },
-        limit: {
-          type: ScalarTypeEnum2.Int_unsecure(),
-          isOptional: true,
-          defaultValue: 20
-        },
-        offset: {
-          type: ScalarTypeEnum2.Int_unsecure(),
-          isOptional: true,
-          defaultValue: 0
-        }
-      }
-    }),
-    output: defineSchemaModel2({
-      name: "ListRunsOutput",
-      fields: {
-        items: { type: RunSummaryModel, isArray: true, isOptional: false },
-        total: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
-        hasMore: { type: ScalarTypeEnum2.Boolean(), isOptional: false }
-      }
-    })
-  },
-  policy: { auth: "user" },
-  acceptance: {
-    scenarios: [
-      {
-        key: "list-runs-happy-path",
-        given: ["Organization has runs"],
-        when: ["User lists runs"],
-        then: ["Paginated list of runs is returned"]
-      }
-    ],
-    examples: [
-      {
-        key: "list-by-agent",
-        input: { agentId: "agent-123", limit: 20, offset: 0 },
-        output: { items: [], total: 0, hasMore: false }
-      }
-    ]
-  }
-});
-var GetRunStepsQuery = defineQuery({
-  meta: {
-    key: "agent.run.getSteps",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["run", "steps"],
-    description: "Retrieves all steps for a specific run.",
-    goal: "View step-by-step execution details.",
-    context: "Run details page - steps tab."
-  },
-  io: {
-    input: defineSchemaModel2({
-      name: "GetRunStepsInput",
-      fields: {
-        runId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-      }
-    }),
-    output: defineSchemaModel2({
-      name: "GetRunStepsOutput",
-      fields: {
-        steps: { type: RunStepModel, isArray: true, isOptional: false }
-      }
-    })
-  },
-  policy: { auth: "user" },
-  acceptance: {
-    scenarios: [
-      {
-        key: "get-run-steps-happy-path",
-        given: ["Run exists with steps"],
-        when: ["User requests steps"],
-        then: ["Steps list is returned"]
-      }
-    ],
-    examples: [
-      {
-        key: "get-steps-basic",
-        input: { runId: "run-456" },
-        output: { steps: [] }
-      }
-    ]
-  }
-});
-var GetRunLogsQuery = defineQuery({
-  meta: {
-    key: "agent.run.getLogs",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["run", "logs"],
-    description: "Retrieves all logs for a specific run.",
-    goal: "Debug and audit run execution.",
-    context: "Run details page - logs tab."
-  },
-  io: {
-    input: defineSchemaModel2({
-      name: "GetRunLogsInput",
-      fields: {
-        runId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-        level: { type: LogLevelEnum, isOptional: true },
-        stepId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-        limit: {
-          type: ScalarTypeEnum2.Int_unsecure(),
-          isOptional: true,
-          defaultValue: 100
-        },
-        offset: {
-          type: ScalarTypeEnum2.Int_unsecure(),
-          isOptional: true,
-          defaultValue: 0
-        }
-      }
-    }),
-    output: defineSchemaModel2({
-      name: "GetRunLogsOutput",
-      fields: {
-        items: { type: RunLogModel, isArray: true, isOptional: false },
-        total: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
-        hasMore: { type: ScalarTypeEnum2.Boolean(), isOptional: false }
-      }
-    })
-  },
-  policy: { auth: "user" },
-  acceptance: {
-    scenarios: [
-      {
-        key: "get-run-logs-happy-path",
-        given: ["Run exists with logs"],
-        when: ["User requests logs"],
-        then: ["Paginated logs list is returned"]
-      }
-    ],
-    examples: [
-      {
-        key: "get-logs-filtered",
-        input: { runId: "run-456", level: "error", limit: 50 },
-        output: { items: [], total: 0, hasMore: false }
-      }
-    ]
-  }
-});
-var GetRunMetricsQuery = defineQuery({
-  meta: {
-    key: "agent.run.getMetrics",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["run", "metrics"],
-    description: "Retrieves aggregated metrics for runs within a time period.",
-    goal: "Monitor and analyze agent usage.",
-    context: "Analytics dashboard."
-  },
-  io: {
-    input: defineSchemaModel2({
-      name: "GetRunMetricsInput",
-      fields: {
-        organizationId: {
-          type: ScalarTypeEnum2.String_unsecure(),
-          isOptional: false
-        },
-        agentId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-        startDate: { type: ScalarTypeEnum2.DateTime(), isOptional: false },
-        endDate: { type: ScalarTypeEnum2.DateTime(), isOptional: false },
-        granularity: {
-          type: GranularityEnum,
-          isOptional: true,
-          defaultValue: "day"
-        }
-      }
-    }),
-    output: defineSchemaModel2({
-      name: "GetRunMetricsOutput",
-      fields: {
-        totalRuns: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
-        completedRuns: {
-          type: ScalarTypeEnum2.Int_unsecure(),
-          isOptional: false
-        },
-        failedRuns: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
-        totalTokens: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
-        totalCostUsd: {
-          type: ScalarTypeEnum2.Float_unsecure(),
-          isOptional: false
-        },
-        averageDurationMs: {
-          type: ScalarTypeEnum2.Float_unsecure(),
-          isOptional: false
-        },
-        successRate: {
-          type: ScalarTypeEnum2.Float_unsecure(),
-          isOptional: false
-        },
-        timeline: {
-          type: TimelineDataPointModel,
-          isArray: true,
-          isOptional: false
-        }
-      }
-    })
-  },
-  policy: { auth: "user" },
-  acceptance: {
-    scenarios: [
-      {
-        key: "get-run-metrics-happy-path",
-        given: ["Organization has run history"],
-        when: ["User requests metrics for date range"],
-        then: ["Aggregated metrics are returned"]
-      }
-    ],
-    examples: [
-      {
-        key: "get-daily-metrics",
-        input: {
-          organizationId: "org-123",
-          startDate: "2025-01-01",
-          endDate: "2025-01-31",
-          granularity: "day"
-        },
-        output: {
-          totalRuns: 100,
-          completedRuns: 90,
-          failedRuns: 10,
-          totalTokens: 50000,
-          totalCostUsd: 5,
-          averageDurationMs: 2500,
-          successRate: 0.9,
-          timeline: []
-        }
-      }
-    ]
-  }
-});
-export {
-  ListRunsQuery,
-  GetRunStepsQuery,
-  GetRunQuery,
-  GetRunMetricsQuery,
-  GetRunLogsQuery,
-  ExecuteAgentCommand,
-  CancelRunCommand
-};
+import{defineEnum as F}from"@contractspec/lib.schema";var x=F("RunStatus",["QUEUED","IN_PROGRESS","COMPLETED","FAILED","CANCELLED","EXPIRED"]),V=F("RunStepType",["MESSAGE_CREATION","TOOL_CALL","TOOL_RESULT","ERROR"]),H=F("LogLevel",["DEBUG","INFO","WARN","ERROR"]),X=F("Granularity",["hour","day","week","month"]);import{defineSchemaModel as z,ScalarTypeEnum as j}from"@contractspec/lib.schema";var Y=z({name:"RunInput",description:"Input data for agent execution",fields:{message:{type:j.NonEmptyString(),isOptional:!1},context:{type:j.JSONObject(),isOptional:!0}}}),K=z({name:"RunStep",description:"Individual step within a run",fields:{id:{type:j.String_unsecure(),isOptional:!1},stepNumber:{type:j.Int_unsecure(),isOptional:!1},type:{type:V,isOptional:!1},toolId:{type:j.String_unsecure(),isOptional:!0},toolName:{type:j.String_unsecure(),isOptional:!0},input:{type:j.JSONObject(),isOptional:!0},output:{type:j.JSONObject(),isOptional:!0},status:{type:x,isOptional:!1},errorMessage:{type:j.String_unsecure(),isOptional:!0},tokensUsed:{type:j.Int_unsecure(),isOptional:!1,defaultValue:0},durationMs:{type:j.Int_unsecure(),isOptional:!0},startedAt:{type:j.DateTime(),isOptional:!1},completedAt:{type:j.DateTime(),isOptional:!0}}}),U=z({name:"RunLog",description:"Execution log entry",fields:{id:{type:j.String_unsecure(),isOptional:!1},stepId:{type:j.String_unsecure(),isOptional:!0},level:{type:H,isOptional:!1},message:{type:j.String_unsecure(),isOptional:!1},data:{type:j.JSONObject(),isOptional:!0},source:{type:j.String_unsecure(),isOptional:!0},traceId:{type:j.String_unsecure(),isOptional:!0},spanId:{type:j.String_unsecure(),isOptional:!0},timestamp:{type:j.DateTime(),isOptional:!1}}}),A=z({name:"RunAgentRef",description:"Agent reference in a run",fields:{id:{type:j.String_unsecure(),isOptional:!1},name:{type:j.NonEmptyString(),isOptional:!1},modelProvider:{type:j.String_unsecure(),isOptional:!1},modelName:{type:j.String_unsecure(),isOptional:!1}}}),Z=z({name:"Run",description:"Agent execution instance",fields:{id:{type:j.String_unsecure(),isOptional:!1},organizationId:{type:j.String_unsecure(),isOptional:!1},agentId:{type:j.String_unsecure(),isOptional:!1},userId:{type:j.String_unsecure(),isOptional:!0},sessionId:{type:j.String_unsecure(),isOptional:!0},input:{type:j.JSONObject(),isOptional:!1},output:{type:j.JSONObject(),isOptional:!0},status:{type:x,isOptional:!1},errorMessage:{type:j.String_unsecure(),isOptional:!0},errorCode:{type:j.String_unsecure(),isOptional:!0},totalTokens:{type:j.Int_unsecure(),isOptional:!1,defaultValue:0},promptTokens:{type:j.Int_unsecure(),isOptional:!1,defaultValue:0},completionTokens:{type:j.Int_unsecure(),isOptional:!1,defaultValue:0},totalIterations:{type:j.Int_unsecure(),isOptional:!1,defaultValue:0},durationMs:{type:j.Int_unsecure(),isOptional:!0},estimatedCostUsd:{type:j.Float_unsecure(),isOptional:!0},queuedAt:{type:j.DateTime(),isOptional:!1},startedAt:{type:j.DateTime(),isOptional:!0},completedAt:{type:j.DateTime(),isOptional:!0},metadata:{type:j.JSONObject(),isOptional:!0},steps:{type:K,isArray:!0,isOptional:!0},logs:{type:U,isArray:!0,isOptional:!0},agent:{type:A,isOptional:!0}}}),J=z({name:"RunSummary",description:"Summary of a run for list views",fields:{id:{type:j.String_unsecure(),isOptional:!1},agentId:{type:j.String_unsecure(),isOptional:!1},agentName:{type:j.NonEmptyString(),isOptional:!1},status:{type:x,isOptional:!1},totalTokens:{type:j.Int_unsecure(),isOptional:!1},durationMs:{type:j.Int_unsecure(),isOptional:!0},estimatedCostUsd:{type:j.Float_unsecure(),isOptional:!0},queuedAt:{type:j.DateTime(),isOptional:!1},completedAt:{type:j.DateTime(),isOptional:!0}}}),_=z({name:"TimelineDataPoint",description:"Timeline data point for metrics",fields:{period:{type:j.String_unsecure(),isOptional:!1},runs:{type:j.Int_unsecure(),isOptional:!1},tokens:{type:j.Int_unsecure(),isOptional:!1},costUsd:{type:j.Float_unsecure(),isOptional:!1},avgDurationMs:{type:j.Float_unsecure(),isOptional:!1}}});import{defineCommand as $,defineQuery as B}from"@contractspec/lib.contracts-spec/operations";import{defineSchemaModel as q,ScalarTypeEnum as k}from"@contractspec/lib.schema";var w=["@agent-console-team"],L=$({meta:{key:"agent.run.execute",version:"1.0.0",stability:"stable",owners:[...w],tags:["run","execute"],description:"Starts a new agent run with the given input.",goal:"Execute an AI agent with user input.",context:"Called from chat interface or API."},io:{input:q({name:"ExecuteAgentInput",fields:{agentId:{type:k.String_unsecure(),isOptional:!1},input:{type:Y,isOptional:!1},sessionId:{type:k.String_unsecure(),isOptional:!0},metadata:{type:k.JSONObject(),isOptional:!0},stream:{type:k.Boolean(),isOptional:!0},maxIterations:{type:k.Int_unsecure(),isOptional:!0},timeoutMs:{type:k.Int_unsecure(),isOptional:!0}}}),output:q({name:"ExecuteAgentOutput",fields:{runId:{type:k.String_unsecure(),isOptional:!1},status:{type:x,isOptional:!1},estimatedWaitMs:{type:k.Int_unsecure(),isOptional:!0}}}),errors:{AGENT_NOT_FOUND:{description:"The specified agent does not exist",http:404,gqlCode:"AGENT_NOT_FOUND",when:"Agent ID is invalid"},AGENT_NOT_ACTIVE:{description:"The specified agent is not active",http:400,gqlCode:"AGENT_NOT_ACTIVE",when:"Agent is in draft/paused/archived state"}}},policy:{auth:"user"},sideEffects:{emits:[{key:"run.started",version:"1.0.0",stability:"stable",owners:[...w],tags:["run","started"],when:"Run is queued",payload:J}],audit:["run.started"]},acceptance:{scenarios:[{key:"execute-agent-happy-path",given:["Agent exists","Agent is active"],when:["User submits execution request"],then:["Run is created","RunStarted event is emitted"]},{key:"execute-agent-not-active",given:["Agent exists but is not active"],when:["User attempts to execute"],then:["AGENT_NOT_ACTIVE error is returned"]}],examples:[{key:"basic-execute",input:{agentId:"agent-123",input:{message:"Hello"}},output:{runId:"run-456",status:"pending",estimatedWaitMs:5000}}]}}),N=$({meta:{key:"agent.run.cancel",version:"1.0.0",stability:"stable",owners:[...w],tags:["run","cancel"],description:"Cancels an in-progress agent run.",goal:"Stop a running agent execution.",context:"Called when user wants to abort a long-running task."},io:{input:q({name:"CancelRunInput",fields:{runId:{type:k.String_unsecure(),isOptional:!1},reason:{type:k.String_unsecure(),isOptional:!0}}}),output:q({name:"CancelRunOutput",fields:{success:{type:k.Boolean(),isOptional:!1},status:{type:x,isOptional:!1}}}),errors:{RUN_NOT_FOUND:{description:"The specified run does not exist",http:404,gqlCode:"RUN_NOT_FOUND",when:"Run ID is invalid"},RUN_NOT_CANCELLABLE:{description:"The run cannot be cancelled",http:400,gqlCode:"RUN_NOT_CANCELLABLE",when:"Run is already completed/failed/cancelled"}}},policy:{auth:"user"},sideEffects:{emits:[{key:"run.cancelled",version:"1.0.0",stability:"stable",owners:[...w],tags:["run","cancelled"],when:"Run is cancelled",payload:J}],audit:["run.cancelled"]},acceptance:{scenarios:[{key:"cancel-run-happy-path",given:["Run exists","Run is in progress"],when:["User cancels run"],then:["Run is cancelled","RunCancelled event is emitted"]},{key:"cancel-run-already-completed",given:["Run exists but is already completed"],when:["User attempts to cancel"],then:["RUN_NOT_CANCELLABLE error is returned"]}],examples:[{key:"cancel-basic",input:{runId:"run-456",reason:"User requested"},output:{success:!0,status:"cancelled"}}]}}),O=B({meta:{key:"agent.run.get",version:"1.0.0",stability:"stable",owners:[...w],tags:["run","get"],description:"Retrieves a run by its ID with optional details.",goal:"View detailed run information.",context:"Run details page or monitoring."},io:{input:q({name:"GetRunInput",fields:{runId:{type:k.String_unsecure(),isOptional:!1},includeSteps:{type:k.Boolean(),isOptional:!0},includeLogs:{type:k.Boolean(),isOptional:!0}}}),output:Z,errors:{RUN_NOT_FOUND:{description:"The specified run does not exist",http:404,gqlCode:"RUN_NOT_FOUND",when:"Run ID is invalid"}}},policy:{auth:"user"},acceptance:{scenarios:[{key:"get-run-happy-path",given:["Run exists"],when:["User requests run by ID"],then:["Run details are returned"]}],examples:[{key:"get-with-steps",input:{runId:"run-456",includeSteps:!0,includeLogs:!1},output:{id:"run-456",status:"completed",steps:[]}}]}}),W=B({meta:{key:"agent.run.list",version:"1.0.0",stability:"stable",owners:[...w],tags:["run","list"],description:"Lists runs with optional filtering.",goal:"Browse and search run history.",context:"Run history/dashboard view."},io:{input:q({name:"ListRunsInput",fields:{organizationId:{type:k.String_unsecure(),isOptional:!0},agentId:{type:k.String_unsecure(),isOptional:!0},userId:{type:k.String_unsecure(),isOptional:!0},sessionId:{type:k.String_unsecure(),isOptional:!0},status:{type:x,isOptional:!0},startDate:{type:k.DateTime(),isOptional:!0},endDate:{type:k.DateTime(),isOptional:!0},limit:{type:k.Int_unsecure(),isOptional:!0,defaultValue:20},offset:{type:k.Int_unsecure(),isOptional:!0,defaultValue:0}}}),output:q({name:"ListRunsOutput",fields:{items:{type:J,isArray:!0,isOptional:!1},total:{type:k.Int_unsecure(),isOptional:!1},hasMore:{type:k.Boolean(),isOptional:!1}}})},policy:{auth:"user"},acceptance:{scenarios:[{key:"list-runs-happy-path",given:["Organization has runs"],when:["User lists runs"],then:["Paginated list of runs is returned"]}],examples:[{key:"list-by-agent",input:{agentId:"agent-123",limit:20,offset:0},output:{items:[],total:0,hasMore:!1}}]}}),s=B({meta:{key:"agent.run.getSteps",version:"1.0.0",stability:"stable",owners:[...w],tags:["run","steps"],description:"Retrieves all steps for a specific run.",goal:"View step-by-step execution details.",context:"Run details page - steps tab."},io:{input:q({name:"GetRunStepsInput",fields:{runId:{type:k.String_unsecure(),isOptional:!1}}}),output:q({name:"GetRunStepsOutput",fields:{steps:{type:K,isArray:!0,isOptional:!1}}})},policy:{auth:"user"},acceptance:{scenarios:[{key:"get-run-steps-happy-path",given:["Run exists with steps"],when:["User requests steps"],then:["Steps list is returned"]}],examples:[{key:"get-steps-basic",input:{runId:"run-456"},output:{steps:[]}}]}}),h=B({meta:{key:"agent.run.getLogs",version:"1.0.0",stability:"stable",owners:[...w],tags:["run","logs"],description:"Retrieves all logs for a specific run.",goal:"Debug and audit run execution.",context:"Run details page - logs tab."},io:{input:q({name:"GetRunLogsInput",fields:{runId:{type:k.String_unsecure(),isOptional:!1},level:{type:H,isOptional:!0},stepId:{type:k.String_unsecure(),isOptional:!0},limit:{type:k.Int_unsecure(),isOptional:!0,defaultValue:100},offset:{type:k.Int_unsecure(),isOptional:!0,defaultValue:0}}}),output:q({name:"GetRunLogsOutput",fields:{items:{type:U,isArray:!0,isOptional:!1},total:{type:k.Int_unsecure(),isOptional:!1},hasMore:{type:k.Boolean(),isOptional:!1}}})},policy:{auth:"user"},acceptance:{scenarios:[{key:"get-run-logs-happy-path",given:["Run exists with logs"],when:["User requests logs"],then:["Paginated logs list is returned"]}],examples:[{key:"get-logs-filtered",input:{runId:"run-456",level:"error",limit:50},output:{items:[],total:0,hasMore:!1}}]}}),R=B({meta:{key:"agent.run.getMetrics",version:"1.0.0",stability:"stable",owners:[...w],tags:["run","metrics"],description:"Retrieves aggregated metrics for runs within a time period.",goal:"Monitor and analyze agent usage.",context:"Analytics dashboard."},io:{input:q({name:"GetRunMetricsInput",fields:{organizationId:{type:k.String_unsecure(),isOptional:!1},agentId:{type:k.String_unsecure(),isOptional:!0},startDate:{type:k.DateTime(),isOptional:!1},endDate:{type:k.DateTime(),isOptional:!1},granularity:{type:X,isOptional:!0,defaultValue:"day"}}}),output:q({name:"GetRunMetricsOutput",fields:{totalRuns:{type:k.Int_unsecure(),isOptional:!1},completedRuns:{type:k.Int_unsecure(),isOptional:!1},failedRuns:{type:k.Int_unsecure(),isOptional:!1},totalTokens:{type:k.Int_unsecure(),isOptional:!1},totalCostUsd:{type:k.Float_unsecure(),isOptional:!1},averageDurationMs:{type:k.Float_unsecure(),isOptional:!1},successRate:{type:k.Float_unsecure(),isOptional:!1},timeline:{type:_,isArray:!0,isOptional:!1}}})},policy:{auth:"user"},acceptance:{scenarios:[{key:"get-run-metrics-happy-path",given:["Organization has run history"],when:["User requests metrics for date range"],then:["Aggregated metrics are returned"]}],examples:[{key:"get-daily-metrics",input:{organizationId:"org-123",startDate:"2025-01-01",endDate:"2025-01-31",granularity:"day"},output:{totalRuns:100,completedRuns:90,failedRuns:10,totalTokens:50000,totalCostUsd:5,averageDurationMs:2500,successRate:0.9,timeline:[]}}]}});export{W as ListRunsQuery,s as GetRunStepsQuery,O as GetRunQuery,R as GetRunMetricsQuery,h as GetRunLogsQuery,L as ExecuteAgentCommand,N as CancelRunCommand};