@openscout/protocol 0.2.63 → 0.2.82

package/dist/agent-runs.js

@@ -0,0 +1,365 @@
+import { normalizeScoutPermissionProfile, } from "./permission-policy.js";
+export const AGENT_RUN_STATES = [
+    "queued",
+    "waking",
+    "running",
+    "waiting",
+    "review",
+    "completed",
+    "failed",
+    "cancelled",
+    "unknown",
+];
+export const AGENT_RUN_SOURCES = [
+    "ask",
+    "message",
+    "schedule",
+    "recipe",
+    "external_issue",
+    "manual",
+    "eval",
+    "unknown",
+];
+export const AGENT_RUN_REVIEW_STATES = [
+    "none",
+    "needed",
+    "blocked",
+    "approved",
+    "rejected",
+];
+export function deriveProjectedAgentRunId(input) {
+    const flightId = trimString(input.flightId);
+    if (flightId) {
+        return `run:flight:${flightId}`;
+    }
+    return `run:invocation:${input.invocationId}`;
+}
+export function projectAgentRunFromInvocationFlight(input) {
+    const { invocation, flight } = input;
+    const agentRevisionSnapshot = input.agentRevisionSnapshot
+        ?? metadataObject(invocation.metadata, "agentRevisionSnapshot");
+    const reviewTaskIds = uniqueIds(input.reviewTaskIds ?? metadataIdList(invocation.metadata, "reviewTaskIds"));
+    const artifactIds = uniqueIds(input.artifactIds ?? metadataIdList(invocation.metadata, "artifactIds"));
+    const traceSessionIds = uniqueIds(input.traceSessionIds ?? metadataIdList(invocation.metadata, "traceSessionIds"));
+    const reviewState = inferReviewState({
+        explicitReviewState: input.reviewState,
+        invocationMetadata: invocation.metadata,
+        flightMetadata: flight?.metadata,
+        reviewTaskIds,
+    });
+    const state = projectAgentRunState(flight?.state, reviewState);
+    const output = projectOutput(flight);
+    const metadata = projectMetadata({
+        invocationMetadata: invocation.metadata,
+        flightMetadata: flight?.metadata,
+        agentRevisionSnapshot,
+    });
+    const permissionProfile = inferPermissionProfile(invocation, agentRevisionSnapshot);
+    const harness = invocation.execution?.harness ?? agentRevisionSnapshot?.runtime?.harness;
+    const model = stringMetadata(invocation.metadata, "model")
+        ?? stringMetadata(flight?.metadata, "model")
+        ?? agentRevisionSnapshot?.runtime?.model;
+    const workId = inferWorkId(invocation);
+    const collaborationRecordId = inferCollaborationRecordId(invocation);
+    const run = {
+        id: deriveProjectedAgentRunId({
+            invocationId: invocation.id,
+            flightId: flight?.id,
+        }),
+        source: input.source ?? inferAgentRunSource(invocation),
+        requesterId: invocation.requesterId,
+        agentId: invocation.targetAgentId,
+        state,
+        input: projectInput(invocation),
+        createdAt: invocation.createdAt,
+        updatedAt: projectUpdatedAt(invocation, flight, input.now),
+    };
+    addOptional(run, "agentRevisionId", agentRevisionSnapshot?.id ?? stringMetadata(invocation.metadata, "agentRevisionId"));
+    addOptional(run, "agentRevisionSnapshot", agentRevisionSnapshot);
+    addOptional(run, "aliasId", stringMetadata(invocation.metadata, "aliasId"));
+    addOptional(run, "workId", workId);
+    addOptional(run, "collaborationRecordId", collaborationRecordId);
+    addOptional(run, "conversationId", invocation.conversationId);
+    addOptional(run, "messageId", invocation.messageId);
+    addOptional(run, "invocationId", invocation.id);
+    addOptional(run, "flightIds", flight ? [flight.id] : undefined);
+    addOptional(run, "parentRunId", stringMetadata(invocation.metadata, "parentRunId"));
+    addOptional(run, "rootRunId", stringMetadata(invocation.metadata, "rootRunId"));
+    addOptional(run, "recipeId", stringMetadata(invocation.metadata, "recipeId"));
+    addOptional(run, "attempt", numberMetadata(invocation.metadata, "attempt"));
+    addOptional(run, "idempotencyKey", stringMetadata(invocation.metadata, "idempotencyKey"));
+    addOptional(run, "reviewState", reviewState);
+    addOptional(run, "terminalReason", terminalReason(flight, state));
+    addOptional(run, "output", output);
+    addOptional(run, "artifactIds", artifactIds.length > 0 ? artifactIds : undefined);
+    addOptional(run, "reviewTaskIds", reviewTaskIds.length > 0 ? reviewTaskIds : undefined);
+    addOptional(run, "traceSessionIds", traceSessionIds.length > 0 ? traceSessionIds : undefined);
+    addOptional(run, "startedAt", flight?.startedAt);
+    addOptional(run, "completedAt", flight?.completedAt);
+    addOptional(run, "harness", harness);
+    addOptional(run, "model", model);
+    addOptional(run, "permissionProfile", permissionProfile);
+    addOptional(run, "metrics", inferMetrics(invocation.metadata, flight?.metadata));
+    addOptional(run, "metadata", metadata);
+    return run;
+}
+/**
+ * Project an AgentRun from the merged invocation record (Phase 3's single source
+ * of truth), where execution status lives on the invocation itself.
+ *
+ * Until the storage merge (PR B+) lands, this re-derives the flight view from the
+ * invocation's status subset and delegates to
+ * {@link projectAgentRunFromInvocationFlight}, so the two projectors stay
+ * behavior-identical and the stable `run:flight:<flightId>` id is preserved. A
+ * record with no durable flightId projects as an invocation-only run, exactly as
+ * the flight-based projector does when no flight is present.
+ */
+export function projectAgentRunFromInvocation(input) {
+    const { invocation } = input;
+    const flight = invocation.flightId
+        ? {
+            id: invocation.flightId,
+            invocationId: invocation.id,
+            requesterId: invocation.requesterId,
+            targetAgentId: invocation.targetAgentId,
+            state: invocation.state ?? "queued",
+            summary: invocation.summary,
+            output: invocation.output,
+            error: invocation.error,
+            startedAt: invocation.startedAt,
+            completedAt: invocation.completedAt,
+            labels: invocation.labels,
+            metadata: invocation.metadata,
+        }
+        : undefined;
+    return projectAgentRunFromInvocationFlight({
+        invocation,
+        flight,
+        now: input.now,
+        source: input.source,
+        reviewState: input.reviewState,
+        agentRevisionSnapshot: input.agentRevisionSnapshot,
+        reviewTaskIds: input.reviewTaskIds,
+        artifactIds: input.artifactIds,
+        traceSessionIds: input.traceSessionIds,
+    });
+}
+export function projectAgentRunState(flightState, reviewState) {
+    if (flightState === "failed") {
+        return "failed";
+    }
+    if (flightState === "cancelled") {
+        return "cancelled";
+    }
+    if (flightState === "completed" && isBlockingReviewState(reviewState)) {
+        return "review";
+    }
+    if (isAgentRunState(flightState)) {
+        return flightState;
+    }
+    return "unknown";
+}
+function projectInput(invocation) {
+    const projected = {
+        action: invocation.action,
+        task: invocation.task,
+        targetAgentId: invocation.targetAgentId,
+        requesterNodeId: invocation.requesterNodeId,
+        ensureAwake: invocation.ensureAwake,
+        stream: invocation.stream,
+    };
+    addOptional(projected, "targetNodeId", invocation.targetNodeId);
+    addOptional(projected, "timeoutMs", invocation.timeoutMs);
+    addOptional(projected, "context", invocation.context);
+    addOptional(projected, "execution", invocation.execution);
+    addOptional(projected, "metadata", invocation.metadata);
+    return projected;
+}
+function projectOutput(flight) {
+    if (!flight) {
+        return undefined;
+    }
+    const output = {};
+    addOptional(output, "summary", flight.summary);
+    addOptional(output, "text", flight.output);
+    addOptional(output, "error", flight.error);
+    addOptional(output, "metadata", flight.metadata);
+    return Object.keys(output).length > 0 ? output : undefined;
+}
+function projectMetadata(input) {
+    const metadata = {};
+    const rawSource = stringMetadata(input.invocationMetadata, "source");
+    addOptional(metadata, "rawSource", rawSource);
+    addOptional(metadata, "invocationMetadata", input.invocationMetadata);
+    addOptional(metadata, "flightMetadata", input.flightMetadata);
+    addOptional(metadata, "agentRevisionSnapshot", input.agentRevisionSnapshot);
+    return Object.keys(metadata).length > 0 ? metadata : undefined;
+}
+function projectUpdatedAt(invocation, flight, now) {
+    if (flight?.completedAt !== undefined) {
+        return flight.completedAt;
+    }
+    if (now !== undefined) {
+        return now;
+    }
+    if (flight?.startedAt !== undefined) {
+        return flight.startedAt;
+    }
+    return invocation.createdAt;
+}
+function inferAgentRunSource(invocation) {
+    const explicit = stringMetadata(invocation.metadata, "agentRunSource")
+        ?? stringMetadata(invocation.metadata, "runSource");
+    if (isAgentRunSource(explicit)) {
+        return explicit;
+    }
+    const rawSource = stringMetadata(invocation.metadata, "source");
+    if (isAgentRunSource(rawSource)) {
+        return rawSource;
+    }
+    switch (rawSource) {
+        case "collaboration-record":
+            return "ask";
+        case "broker-deliver":
+            return "message";
+        case "scout-app":
+            return invocation.messageId ? "message" : "manual";
+        case "scout-cli":
+            return invocation.messageId ? "message" : "ask";
+        default:
+            break;
+    }
+    if (invocation.collaborationRecordId
+        || metadataObject(invocation.context, "collaboration")
+        || stringMetadata(invocation.context, "collaborationRecordId")) {
+        return "ask";
+    }
+    if (invocation.messageId || invocation.conversationId) {
+        return "message";
+    }
+    if (invocation.action === "wake") {
+        return "manual";
+    }
+    return "ask";
+}
+function inferReviewState(input) {
+    if (input.explicitReviewState) {
+        return input.explicitReviewState;
+    }
+    const metadataReviewState = stringMetadata(input.flightMetadata, "reviewState")
+        ?? stringMetadata(input.invocationMetadata, "reviewState");
+    if (isAgentRunReviewState(metadataReviewState)) {
+        return metadataReviewState;
+    }
+    if (input.reviewTaskIds.length > 0
+        || booleanMetadata(input.flightMetadata, "reviewNeeded")
+        || booleanMetadata(input.flightMetadata, "needsReview")
+        || booleanMetadata(input.flightMetadata, "requiresReview")
+        || booleanMetadata(input.invocationMetadata, "reviewNeeded")
+        || booleanMetadata(input.invocationMetadata, "needsReview")
+        || booleanMetadata(input.invocationMetadata, "requiresReview")) {
+        return "needed";
+    }
+    return undefined;
+}
+function inferPermissionProfile(invocation, agentRevisionSnapshot) {
+    return invocation.execution?.permissionProfile
+        ?? normalizeScoutPermissionProfile(stringMetadata(invocation.metadata, "permissionProfile"))
+        ?? normalizeScoutPermissionProfile(agentRevisionSnapshot?.permissions?.permissionProfile);
+}
+function inferMetrics(invocationMetadata, flightMetadata) {
+    const metrics = metadataObject(flightMetadata, "metrics")
+        ?? metadataObject(invocationMetadata, "metrics");
+    if (!metrics) {
+        return undefined;
+    }
+    const projected = {};
+    addOptional(projected, "inputTokens", numberMetadata(metrics, "inputTokens"));
+    addOptional(projected, "outputTokens", numberMetadata(metrics, "outputTokens"));
+    addOptional(projected, "totalTokens", numberMetadata(metrics, "totalTokens"));
+    addOptional(projected, "estimatedUsd", numberMetadata(metrics, "estimatedUsd"));
+    addOptional(projected, "wallClockMs", numberMetadata(metrics, "wallClockMs"));
+    addOptional(projected, "toolCallCount", numberMetadata(metrics, "toolCallCount"));
+    addOptional(projected, "retryCount", numberMetadata(metrics, "retryCount"));
+    return Object.keys(projected).length > 0 ? projected : undefined;
+}
+function inferWorkId(invocation) {
+    return stringMetadata(invocation.metadata, "workId")
+        ?? stringMetadata(invocation.context, "workId")
+        ?? inferCollaborationWorkId(invocation);
+}
+function inferCollaborationRecordId(invocation) {
+    return invocation.collaborationRecordId
+        ?? stringMetadata(invocation.metadata, "collaborationRecordId")
+        ?? stringMetadata(invocation.context, "collaborationRecordId")
+        ?? stringMetadata(metadataObject(invocation.context, "collaboration"), "recordId");
+}
+function inferCollaborationWorkId(invocation) {
+    const collaboration = metadataObject(invocation.context, "collaboration");
+    const collaborationKind = stringMetadata(invocation.metadata, "collaborationRecordKind")
+        ?? stringMetadata(invocation.context, "collaborationRecordKind")
+        ?? stringMetadata(collaboration, "kind")
+        ?? stringMetadata(collaboration, "recordKind");
+    if (collaborationKind !== "work_item") {
+        return undefined;
+    }
+    return invocation.collaborationRecordId
+        ?? stringMetadata(invocation.metadata, "collaborationRecordId")
+        ?? stringMetadata(invocation.context, "collaborationRecordId")
+        ?? stringMetadata(collaboration, "recordId");
+}
+function terminalReason(flight, state) {
+    if (!flight || (state !== "failed" && state !== "cancelled")) {
+        return undefined;
+    }
+    return trimString(flight.error) ?? trimString(flight.summary);
+}
+function isBlockingReviewState(state) {
+    return state === "needed" || state === "blocked";
+}
+function isAgentRunState(value) {
+    return typeof value === "string" && AGENT_RUN_STATES.includes(value);
+}
+function isAgentRunSource(value) {
+    return typeof value === "string" && AGENT_RUN_SOURCES.includes(value);
+}
+function isAgentRunReviewState(value) {
+    return typeof value === "string" && AGENT_RUN_REVIEW_STATES.includes(value);
+}
+function metadataObject(metadata, key) {
+    const value = metadata?.[key];
+    return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function stringMetadata(metadata, key) {
+    const value = metadata?.[key];
+    return trimString(typeof value === "string" ? value : undefined);
+}
+function numberMetadata(metadata, key) {
+    const value = metadata?.[key];
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function booleanMetadata(metadata, key) {
+    return metadata?.[key] === true;
+}
+function metadataIdList(metadata, key) {
+    const value = metadata?.[key];
+    if (Array.isArray(value)) {
+        return value
+            .map((item) => trimString(typeof item === "string" ? item : undefined))
+            .filter((item) => Boolean(item));
+    }
+    const single = trimString(typeof value === "string" ? value : undefined);
+    return single ? [single] : [];
+}
+function uniqueIds(ids) {
+    return [...new Set(ids.map((id) => id.trim()).filter(Boolean))];
+}
+function trimString(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function addOptional(target, key, value) {
+    if (value !== undefined) {
+        target[key] = value;
+    }
+}

package/dist/assigned-roles.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Assigned roles: small explicit duties with hooks and allowed actions.
+ *
+ * Not agentClass, harness, or identity. No assignment → no hooks → no mission log.
+ * First role: orchestrator (mission spine + cheap mission log).
+ *
+ * See docs/proposals/assigned-roles-and-mission-log.md
+ */
+import type { MetadataMap, ScoutId } from "./common.js";
+export declare const SCOUT_ROLE_HOOK_IDS: readonly ["mission.started", "turn.ended", "delegation.created", "child.updated", "waiting.entered", "mission.heartbeat", "mission.finished"];
+export type ScoutRoleHookId = (typeof SCOUT_ROLE_HOOK_IDS)[number];
+/**
+ * Scout-side lifecycle moments (broker fires these; role definitions bind actions).
+ * Distinct from optional soft "hooks" the agent may also honor.
+ */
+export declare const SCOUT_ROLE_LIFECYCLE_EVENT_IDS: readonly ["ask.completed", "ask.failed", "work.completed"];
+export type ScoutRoleLifecycleEventId = (typeof SCOUT_ROLE_LIFECYCLE_EVENT_IDS)[number];
+/** Who must hold the role for a lifecycle binding to run. */
+export type ScoutRoleLifecycleWhen = "target" | "requester" | "either";
+export declare const SCOUT_MISSION_LOG_APPEND: "mission_log.append";
+export declare const SCOUT_WORK_CHILD_LINK: "work.child_link";
+export declare const SCOUT_WORK_SET_NEXT_MOVE: "work.set_next_move";
+export declare const SCOUT_ROLE_ACTION_IDS: readonly ["mission_log.append", "work.child_link", "work.set_next_move"];
+/** Closed set for catalog authoring; open only at untrusted boundaries if needed. */
+export type ScoutRoleActionId = (typeof SCOUT_ROLE_ACTION_IDS)[number];
+/**
+ * Role-owned function at a lifecycle moment.
+ * Example: orchestrator → on ask.completed → mission_log.append (post_ask_summary).
+ */
+export interface ScoutRoleLifecycleBinding {
+    on: ScoutRoleLifecycleEventId;
+    action: ScoutRoleActionId;
+    when: ScoutRoleLifecycleWhen;
+    /**
+     * Stable function id for logs/telemetry (role-defined name of the behavior).
+     * e.g. post_ask_summary, post_work_summary
+     */
+    functionId: string;
+}
+export declare const SCOUT_ORCHESTRATOR_ROLE_ID: "orchestrator";
+/** Built-in role ids. Future roles append here and stay closed in the catalog. */
+export type ScoutBuiltinRoleId = typeof SCOUT_ORCHESTRATOR_ROLE_ID;
+/** Role id on definitions/assignments; catalog rows use built-ins. */
+export type ScoutRoleId = ScoutBuiltinRoleId | (string & {});
+export interface ScoutRoleDefinition {
+    id: ScoutRoleId;
+    label: string;
+    summary: string;
+    hooks: readonly ScoutRoleHookId[];
+    actions: readonly ScoutRoleActionId[];
+    /**
+     * Scout-enforced lifecycle functions for this role.
+     * Fired by the broker at ask/work boundaries — not agent-loaded hooks.
+     */
+    lifecycle?: readonly ScoutRoleLifecycleBinding[];
+}
+/** Orchestrator lifecycle: auto post-ask / post-work summary into mission log. */
+export declare const SCOUT_ORCHESTRATOR_LIFECYCLE: readonly ScoutRoleLifecycleBinding[];
+export declare const SCOUT_ORCHESTRATOR_ROLE: ScoutRoleDefinition;
+/** Built-in catalog. Future roles (qa, sre, reviewer) append here. */
+export declare const SCOUT_ROLE_CATALOG: readonly ScoutRoleDefinition[];
+/**
+ * Mission scope uses a work-item id in v0 (campaign root).
+ * Agent scope is a standing duty on that agent.
+ * Project scope is reserved for Slice 1+ (requires projectRoot in context).
+ */
+export type ScoutRoleAssignmentScope = {
+    kind: "mission";
+    missionId: ScoutId;
+} | {
+    kind: "agent";
+} | {
+    kind: "project";
+    projectRoot: string;
+};
+export interface ScoutRoleAssignment {
+    id: ScoutId;
+    roleId: ScoutRoleId;
+    agentId: ScoutId;
+    scope: ScoutRoleAssignmentScope;
+    assignedById: ScoutId;
+    assignedAt: number;
+    active: boolean;
+    revokedAt?: number;
+    revokedById?: ScoutId;
+    metadata?: MetadataMap;
+}
+/** Context used to decide whether an assignment applies. */
+export interface ScoutRoleScopeContext {
+    missionId?: ScoutId;
+    projectRoot?: string;
+}
+export declare const SCOUT_MISSION_LOG_KINDS: readonly ["heartbeat", "progress", "delegation", "waiting", "decision", "risk", "integration", "done", "failed"];
+export type ScoutMissionLogKind = (typeof SCOUT_MISSION_LOG_KINDS)[number];
+/** Soft limits for writers, tool schemas, and prompts — single source of truth. */
+export declare const SCOUT_MISSION_LOG_LIMITS: {
+    readonly intentMaxWords: 16;
+    /** Short current-action line (field name: `status`, not `now`). */
+    readonly statusMaxWords: 24;
+    readonly noteMaxChars: 240;
+};
+export interface ScoutMissionLogBlocker {
+    label: string;
+    ownerId?: ScoutId;
+    metadata?: MetadataMap;
+}
+export interface ScoutMissionLogRefs {
+    messageId?: ScoutId;
+    flightId?: ScoutId;
+    workId?: ScoutId;
+    sessionId?: ScoutId;
+    invocationId?: ScoutId;
+}
+/**
+ * Cheap structured entry written by an assigned orchestrator (or other role
+ * that lists mission_log.append). Prefer short intent/status; optional note max
+ * one sentence when truly useful.
+ *
+ * v0 persistence may map only a subset into work.progress + collaboration_events
+ * (lossy). Full fidelity wants an append-only log store in Slice 2+.
+ */
+export interface ScoutMissionLogEntry {
+    id: ScoutId;
+    /** Work-item id of the campaign root (v0). */
+    missionId: ScoutId;
+    /** Child work / flight node when the entry is about a branch. */
+    nodeId?: ScoutId;
+    at: number;
+    /** Per-mission monotonic order; avoids same-ms collisions in UI. */
+    seq?: number;
+    actorId: ScoutId;
+    kind: ScoutMissionLogKind;
+    /** Stable goal for this node (keep short). */
+    intent: string;
+    /** Current action / state (keep short). Not a timestamp. */
+    status: string;
+    checkpoint?: string;
+    blockers?: ScoutMissionLogBlocker[];
+    refs?: ScoutMissionLogRefs;
+    note?: string;
+    metadata?: MetadataMap;
+}
+export interface ScoutMissionLogAppendInput {
+    missionId: ScoutId;
+    nodeId?: ScoutId;
+    actorId: ScoutId;
+    kind: ScoutMissionLogKind;
+    intent: string;
+    status: string;
+    checkpoint?: string;
+    blockers?: ScoutMissionLogBlocker[];
+    refs?: ScoutMissionLogRefs;
+    note?: string;
+    metadata?: MetadataMap;
+    /** Caller-supplied id; store may assign if omitted. */
+    id?: ScoutId;
+    at?: number;
+    seq?: number;
+}
+export declare function scoutRoleDefinition(roleId: string, catalog?: readonly ScoutRoleDefinition[]): ScoutRoleDefinition | undefined;
+export declare function isScoutRoleHookId(value: string): value is ScoutRoleHookId;
+export declare function isScoutMissionLogKind(value: string): value is ScoutMissionLogKind;
+export declare function assignmentAppliesTo(assignment: ScoutRoleAssignment, ctx: ScoutRoleScopeContext): boolean;
+export declare function activeScoutRoleAssignments(assignments: readonly ScoutRoleAssignment[]): ScoutRoleAssignment[];
+export declare function scoutRoleAssignmentsForAgent(assignments: readonly ScoutRoleAssignment[], agentId: string, opts?: {
+    activeOnly?: boolean;
+}): ScoutRoleAssignment[];
+export declare function scoutRoleAssignmentsForMission(assignments: readonly ScoutRoleAssignment[], missionId: string, opts?: {
+    activeOnly?: boolean;
+    roleId?: string;
+    /** Include standing agent-scope assignments (default true for "who covers this mission"). */
+    includeStanding?: boolean;
+}): ScoutRoleAssignment[];
+/** Distinct agent ids holding an active role for a mission (incl. standing if enabled). */
+export declare function activeRoleHoldersForMission(assignments: readonly ScoutRoleAssignment[], missionId: string, roleId: string, opts?: {
+    includeStanding?: boolean;
+}): ScoutId[];
+/**
+ * True when this agent may write the mission log for a mission under the
+ * anti-spam rules: active assignment whose definition includes mission_log.append
+ * and whose scope applies to the mission (or standing agent-scope).
+ */
+export declare function agentMayWriteMissionLog(opts: {
+    agentId: string;
+    missionId: string;
+    assignments: readonly ScoutRoleAssignment[];
+    catalog?: readonly ScoutRoleDefinition[];
+    projectRoot?: string;
+}): boolean;
+export declare function roleDefinitionAllowsHook(definition: ScoutRoleDefinition, hookId: ScoutRoleHookId): boolean;
+export declare function assignmentsMatchingHook(opts: {
+    hookId: ScoutRoleHookId;
+    assignments: readonly ScoutRoleAssignment[];
+    context?: ScoutRoleScopeContext;
+    catalog?: readonly ScoutRoleDefinition[];
+}): ScoutRoleAssignment[];
+export type MissionLogEntryValidation = {
+    ok: true;
+} | {
+    ok: false;
+    errors: string[];
+};
+/** Soft structural validation for writers and tests (untrusted tool args). */
+export declare function validateMissionLogEntryFields(input: Pick<ScoutMissionLogAppendInput, "intent" | "status" | "note" | "kind">): MissionLogEntryValidation;
+//# sourceMappingURL=assigned-roles.d.ts.map

package/dist/assigned-roles.d.ts.map

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