intentdna 1.7.4 → 1.8.0

package/dist/templates/workflow-runtime-smoke-review.dna.yaml

@@ -0,0 +1,252 @@
+# workflow-runtime-smoke-review: runtime surface smoke review after rollout or sync
+# Source: extracted from Flutter rewrite dogfood ACTS e2e UI/logcat evidence
+# Purpose: prove a synced or distributed runtime surface is usable before wider rollout
+
+version: "0.1.0"
+id: template_workflow_runtime_smoke_review
+name: Workflow Runtime Smoke Review
+purpose: Prove a synced, deployed, or distributed runtime surface is usable before wider rollout or completion claims.
+maturity: reviewed
+fit:
+  - Post-sync, post-rollout, or post-deploy checks where opening the real surface matters.
+  - CLI, agent, web, mobile, or desktop surfaces that need target-specific smoke evidence.
+not_for:
+  - Treating sync or deploy command success as product runtime proof by itself.
+  - Moving runtime authority to Online, marketplace, Supabase, or dashboard projections.
+inputs:
+  - rollout or sync plan
+  - runtime target and expected surface
+  - smoke command, route, screenshot, log, or output evidence
+outputs:
+  - runtime smoke plan
+  - smoke evidence directory
+  - reviewed smoke verdict and rollout route
+lineage:
+  source: Flutter rewrite dogfood ACTS runtime smoke evidence
+  reference: /Users/samuel/lawark/lwk_flutter_v2-rewrite/.dna/fix-progress
+type: project
+namespace: wrsr
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+variables:
+  rollout_plan_path:
+    description: "Organization rollout or sync plan artifact"
+    default: ".dna/rollout/$ARGUMENTS.rollout.json"
+  smoke_evidence_path:
+    description: "Runtime smoke evidence directory"
+    default: ".dna/runtime-smoke/$ARGUMENTS"
+  smoke_review_path:
+    description: "Runtime smoke review artifact path"
+    default: ".dna/runtime-smoke/$ARGUMENTS.review.json"
+  runtime_target:
+    description: "Runtime target such as codex, claude, web, android, ios, or desktop"
+    default: "$ARGUMENTS"
+
+evidence:
+  - label: Flutter rewrite ACTS e2e runtime evidence
+    kind: reference
+    path: /Users/samuel/lawark/lwk_flutter_v2-rewrite/.dna/fix-progress
+    description: Dogfood ACTS runtime smoke artifacts: screenshots, UI XML, UI summaries, logcat captures, route probes, crash dialogs, and login/fullscreen blockers.
+  - label: IntentDNA release deploy gate
+    kind: reference
+    path: docs/archive/2026H1/workflows/release-runbook.md
+    description: Existing release gate that requires deployed URL verification when web/public surfaces changed.
+
+genes:
+  runtime_smoke_after_sync:
+    description: Runtime sync or rollout is not complete until the target surface is opened, probed, and evidenced
+    codons:
+      - type: attract
+        target: runtime_surface_opened
+      - type: attract
+        target: smoke_evidence_captured
+      - type: repel
+        target: sync_command_as_success_claim
+      - type: threshold
+        condition: "runtime_smoke_evidence_present == true"
+        action: block
+
+  blocker_classification_before_rollout:
+    description: Crash, login, route, permission, loading, and stale-surface blockers must be classified before wider distribution
+    codons:
+      - type: attract
+        target: crash_log_review
+      - type: attract
+        target: ui_state_review
+      - type: attract
+        target: route_probe_review
+      - type: repel
+        target: ignored_runtime_blocker
+      - type: sense
+        signal: smoke_blocker_detected
+        response: block_rollout
+
+  target_specific_verification:
+    description: Smoke checks adapt to target surface while keeping governance in dna core
+    codons:
+      - type: attract
+        target: target_specific_probe
+      - type: attract
+        target: canonical_smoke_artifact
+      - type: repel
+        target: harness_specific_policy_truth
+      - type: threshold
+        condition: "smoke_review_written == true"
+        action: block
+
+contexts: {}
+
+roles:
+  smoke_planner:
+    description: Chooses the smallest runtime smoke path for the target surface after rollout or sync.
+    tool_permissions:
+      allow: [Read, Grep, Glob]
+      deny: [Edit, Write, Bash, NotebookEdit]
+    scope:
+      read: ["**/*", ".dna/**", "docs/**"]
+      write: []
+    instructions:
+      - Read {{rollout_plan_path}} when present and identify the runtime target, asset, and expected surface.
+      - Define the smallest smoke path that proves the target can open and reach the intended route or capability.
+      - For web/public surfaces, include deployed URL verification from dna release deploy-plan when required.
+      - For CLI or agent surfaces, include a post-sync command or dry smoke that proves generated artifacts are usable.
+      - For mobile/desktop surfaces, include screenshot, UI tree/summary, logs, and route probes when available.
+      - Do not treat a sync command by itself as runtime success.
+
+  smoke_collector:
+    description: Collects runtime smoke evidence without changing governance assets or policy truth.
+    tool_permissions:
+      allow: [Read, Write, Grep, Glob, Bash]
+      deny: [Edit, NotebookEdit]
+    scope:
+      read: ["**/*", ".dna/**", "docs/**"]
+      write: [".dna/runtime-smoke/**"]
+    instructions:
+      - Run only the agreed smoke commands for {{runtime_target}}.
+      - Capture command status, stdout/stderr or logs, screenshots where relevant, UI summaries where relevant, route/output evidence, and timestamps under {{smoke_evidence_path}}.
+      - If the smoke cannot run, record the exact environment blocker and required human action.
+      - Do not edit app code, templates, organization profiles, dashboard state, evolution markers, or runtime sync artifacts.
+
+  smoke_reviewer:
+    description: Reviews runtime smoke evidence and classifies blockers before rollout or sync claims are accepted.
+    tool_permissions:
+      allow: [Read, Grep, Glob]
+      deny: [Edit, Write, Bash, NotebookEdit]
+    scope:
+      read: ["**/*", ".dna/**", "docs/**"]
+      write: []
+    instructions:
+      - Read all artifacts under {{smoke_evidence_path}} before judging runtime readiness.
+      - Classify findings as PASS, CRASH_BLOCKER, LOGIN_BLOCKER, ROUTE_BLOCKER, PERMISSION_BLOCKER, LOADING_BLOCKER, STALE_SURFACE, INFRA_BLOCKER, or INCONCLUSIVE.
+      - Reject rollout if the app is stuck on launcher, crash dialog, login wall, fullscreen system prompt, missing route, or stale surface unless explicitly accepted as out of scope.
+      - Distinguish product blockers from environment blockers and missing evidence.
+      - Return PASS, REQUEST_CHANGES, BLOCKED, or INCONCLUSIVE with evidence paths.
+
+  manager_reviewer:
+    description: Produces a manager-readable runtime distribution decision.
+    tool_permissions:
+      allow: [Read, Write, Grep, Glob]
+      deny: [Edit, Bash, NotebookEdit]
+    scope:
+      read: ["**/*", ".dna/**", "docs/**"]
+      write: [".dna/runtime-smoke/**"]
+    instructions:
+      - Write {{smoke_review_path}} with target, asset, status, blocker classification, evidence paths, next commands, and updated_at.
+      - State whether rollout, runtime sync, public deploy verification, or wider distribution is allowed.
+      - If blocked, route to fix/review, completion audit, deploy-plan verification, or environment setup as appropriate.
+      - Keep Obsidian/wiki as internal memory only; use runtime smoke artifacts as product evidence.
+
+workflows:
+  runtime-smoke-review:
+    name: Runtime Smoke Review
+    description: Plan, collect, review, and route runtime smoke evidence after rollout or sync before wider distribution.
+    steps:
+      - id: plan-smoke
+        role: smoke_planner
+        description: Choose the smallest target-specific smoke path for the runtime surface.
+        prompt: |
+          Plan runtime smoke for $ARGUMENTS.
+          Read {{rollout_plan_path}} if it exists.
+          Define the minimal smoke path for {{runtime_target}} and required evidence under {{smoke_evidence_path}}.
+          Do not treat sync completion as runtime proof.
+        handoff:
+          produces:
+            - type: summary
+              name: smoke_plan
+              description: Runtime target, expected route/capability, commands, and evidence requirements.
+      - id: collect-smoke
+        role: smoke_collector
+        depends_on: [plan-smoke]
+        description: Run smoke commands and capture canonical runtime evidence.
+        prompt: |
+          Collect runtime smoke evidence for $ARGUMENTS into {{smoke_evidence_path}}.
+          Capture command status, logs, screenshots/UI summaries when relevant, and route/output evidence.
+          If smoke cannot run, record the environment blocker instead of claiming success.
+        handoff:
+          consumes:
+            - type: summary
+              name: smoke_plan
+              from: plan-smoke
+              description: Smoke plan.
+          produces:
+            - type: file
+              path: "{{smoke_evidence_path}}"
+              description: Runtime smoke evidence directory.
+      - id: review-smoke
+        role: smoke_reviewer
+        depends_on: [collect-smoke]
+        description: Review runtime smoke evidence and classify blockers.
+        prompt: |
+          Review runtime smoke evidence under {{smoke_evidence_path}} for $ARGUMENTS.
+          Classify blockers and return PASS, REQUEST_CHANGES, BLOCKED, or INCONCLUSIVE with evidence paths.
+        handoff:
+          consumes:
+            - type: file
+              path: "{{smoke_evidence_path}}"
+              from: collect-smoke
+              description: Runtime smoke evidence.
+          produces:
+            - type: summary
+              name: smoke_review_verdict
+              description: Runtime smoke verdict, blockers, and evidence paths.
+      - id: manager-route
+        role: manager_reviewer
+        depends_on: [review-smoke]
+        description: Write manager-readable runtime distribution decision.
+        prompt: |
+          Write {{smoke_review_path}} for $ARGUMENTS.
+          Include target, asset, status, blocker classification, evidence paths, next commands, and updated_at.
+          State whether rollout, sync, deployed URL verification, or wider distribution is allowed.
+        checkpoints:
+          - assert: smoke_review_artifact_written
+            command: "test -s \"{{smoke_review_path}}\""
+            message: "Runtime smoke review artifact must exist before wider rollout."
+            action: block
+        handoff:
+          consumes:
+            - type: summary
+              name: smoke_review_verdict
+              from: review-smoke
+              description: Runtime smoke verdict.
+          produces:
+            - type: file
+              path: "{{smoke_review_path}}"
+              description: Durable runtime smoke review JSON.
+
+controllers:
+  runtime-smoke-review:
+    name: Runtime Smoke Review
+    description: "Review runtime smoke evidence after rollout or sync before wider distribution."
+    kind: sequential
+    workflow: runtime-smoke-review
+    max_rounds: 1
+    progress_artifact_path: ".dna/runtime-smoke/$ARGUMENTS.controller.json"
+    roles:
+      smoke_planner: smoke_planner
+      smoke_collector: smoke_collector
+      smoke_reviewer: smoke_reviewer
+      manager_reviewer: manager_reviewer
+    stop_format: configured_stop_report

package/dist/templates/workflow-verification-command-routing.dna.yaml

@@ -0,0 +1,278 @@
+# workflow-verification-command-routing: choose the authoritative verification command and evidence capture path
+# Source: extracted from Flutter rewrite dogfood ACTS/Gallery/AAC verification failures
+# Purpose: prevent false pass/fail evidence caused by running tests from the wrong root, wrong scope, or without canonical summaries
+
+version: "0.1.0"
+id: template_workflow_verification_command_routing
+name: Workflow Verification Command Routing
+purpose: Select the authoritative verification command root, scope, and evidence format before completion, adoption, rollout, or sync.
+maturity: reviewed
+fit:
+  - Test or verification results from ambiguous roots, packages, or scopes.
+  - Completion claims requiring canonical machine-readable evidence.
+not_for:
+  - Replacing the actual test command with prose.
+  - Treating wrong-root failures as valid product evidence.
+inputs:
+  - target module, package, route, or workflow
+  - diagnosis or baseline artifact
+  - candidate verification command
+outputs:
+  - verification route plan
+  - routed command output
+  - canonical verification summary
+lineage:
+  source: Flutter rewrite dogfood verification failures
+  reference: /Users/samuel/lawark/lwk_flutter_v2-rewrite/.dna/fix-progress
+type: project
+namespace: wvcr
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+variables:
+  target:
+    description: "Module, package, route, or workflow target to verify"
+    default: "$ARGUMENTS"
+  diagnosis_path:
+    description: "Optional diagnosis or baseline artifact path"
+    default: ".dna/specs/diagnosis-$ARGUMENTS.md"
+  route_plan_path:
+    description: "Verification route plan artifact path"
+    default: ".dna/verification-routing/$ARGUMENTS.route.json"
+  route_verdict_path:
+    description: "Verification route review verdict artifact path"
+    default: ".dna/verification-routing/$ARGUMENTS.route-verdict.json"
+  evidence_dir:
+    description: "Directory for routed verification command output"
+    default: ".dna/verification-routing/$ARGUMENTS"
+  verification_summary_path:
+    description: "Canonical verification summary path"
+    default: ".dna/verification-routing/$ARGUMENTS.summary.json"
+
+evidence:
+  - label: Flutter rewrite ACTS wrong-root verification note
+    kind: reference
+    path: /Users/samuel/lawark/lwk_flutter_v2-rewrite/.dna/fix-progress/ACTS.md
+    description: ACTS dogfood evidence records that running flutter test from the worktree root is invalid because that root has no pubspec.yaml; valid behavior evidence came from the v2 project root.
+  - label: Flutter rewrite Gallery package-root verification note
+    kind: reference
+    path: /Users/samuel/lawark/lwk_flutter_v2-rewrite/.dna/fix-progress/Gallery.md
+    description: Gallery dogfood evidence records that final verification must run from the feature_gallery package root, not the standalone behavior-test directory.
+  - label: Flutter rewrite AAC completion evidence
+    kind: reference
+    path: /Users/samuel/lawark/lwk_flutter_v2-rewrite/.dna/fix-progress/AAC.md
+    description: AAC dogfood evidence records canonical status, machine log, parsed summary, red classification, and skipped-test checks before accepting PASS.
+
+genes:
+  verification_root_must_match_target:
+    description: Verification evidence is authoritative only when the command runs from the target's required project/package root
+    codons:
+      - type: attract
+        target: verified_command_root
+      - type: attract
+        target: target_specific_test_scope
+      - type: repel
+        target: wrong_root_test_result
+      - type: threshold
+        condition: "verification_command_root_confirmed == true"
+        action: block
+
+  canonical_machine_evidence_required:
+    description: Completion and manager review require machine-readable verification output plus parsed summary/classification artifacts
+    codons:
+      - type: attract
+        target: machine_log_capture
+      - type: attract
+        target: parsed_summary_capture
+      - type: attract
+        target: red_classification_capture
+      - type: repel
+        target: console_summary_only
+      - type: threshold
+        condition: "canonical_verification_summary_written == true"
+        action: block
+
+  invalid_verification_is_not_progress:
+    description: Environment, dependency, wrong-root, stale-scope, and no-test-found failures must be classified before acting on them
+    codons:
+      - type: attract
+        target: verification_blocker_classification
+      - type: repel
+        target: invalid_run_as_product_failure
+      - type: repel
+        target: green_run_without_scope_check
+      - type: sense
+        signal: invalid_verification_route
+        response: request_route_replan
+
+contexts: {}
+
+roles:
+  route_planner:
+    description: Finds the authoritative verification root, command, target scope, and required evidence artifacts before a test/analyze/build command runs.
+    tool_permissions:
+      allow: [Read, Write, Grep, Glob]
+      deny: [Edit, Bash, NotebookEdit]
+    scope:
+      read: ["**/*", ".dna/**", "docs/**"]
+      write: [".dna/verification-routing/**"]
+    instructions:
+      - Read {{diagnosis_path}} when it exists and identify the target module/package/workflow being verified.
+      - Inspect project/package roots before proposing a command; do not assume the repository root is the runnable root.
+      - Choose the smallest command that proves {{target}} while preserving authoritative evidence.
+      - Write {{route_plan_path}} with cwd, command, expected test files or routes, machine/log outputs, parsed summary, red classification, and skipped-test comparison requirements.
+      - If no authoritative command can be chosen, classify the blocker instead of inventing a green path.
+
+  route_reviewer:
+    description: Reviews the proposed verification route for wrong-root, stale-scope, missing evidence, or weak partial-run risk.
+    tool_permissions:
+      allow: [Read, Write, Grep, Glob]
+      deny: [Edit, Bash, NotebookEdit]
+    scope:
+      read: ["**/*", ".dna/**", "docs/**"]
+      write: [".dna/verification-routing/**"]
+    instructions:
+      - Read {{route_plan_path}} before judging the route.
+      - Reject routes that run from a directory without the required project/package context.
+      - Reject routes that do not produce machine-readable output, command status, parsed summary, and red/skipped classification when those artifacts are required.
+      - Distinguish a valid focused command from weak partial evidence.
+      - Write {{route_verdict_path}} with APPROVE, REQUEST_CHANGES, or BLOCKED and evidence paths.
+
+  evidence_runner:
+    description: Runs only the reviewed verification route and records canonical command evidence.
+    tool_permissions:
+      allow: [Read, Write, Grep, Glob, Bash]
+      deny: [Edit, NotebookEdit]
+    scope:
+      read: ["**/*", ".dna/**", "docs/**"]
+      write: [".dna/verification-routing/**"]
+    instructions:
+      - Run only the command from {{route_plan_path}} after {{route_verdict_path}} approves the route.
+      - Capture command status, stdout/stderr or machine logs, parsed summary, red classification, skipped comparison, cwd, and timestamps under {{evidence_dir}}.
+      - If the command cannot run, record WRONG_ROOT, DEPENDENCY, NO_TEST_FOUND, STALE_SCOPE, INFRA, or INCONCLUSIVE instead of treating it as product failure or success.
+      - Do not edit app code, tests, templates, organization profiles, dashboard state, or runtime sync artifacts.
+
+  manager_reviewer:
+    description: Produces a manager-readable verification route decision before completion audit, adoption, rollout, or sync.
+    tool_permissions:
+      allow: [Read, Write, Grep, Glob]
+      deny: [Edit, Bash, NotebookEdit]
+    scope:
+      read: ["**/*", ".dna/**", "docs/**"]
+      write: [".dna/verification-routing/**"]
+    instructions:
+      - Write {{verification_summary_path}} with target, cwd, command, status, blocker classification, evidence paths, counts, and next commands.
+      - State whether the evidence may feed completion audit, manager review, adoption, rollout, evolution preview, or runtime sync.
+      - If the route is invalid, send the work back to route planning rather than completion audit.
+      - Keep Obsidian/wiki as internal memory only; use command artifacts as product evidence.
+
+workflows:
+  verification-command-routing:
+    name: Verification Command Routing
+    description: Plan, review, run, and record the authoritative verification command before completion, adoption, rollout, or sync decisions.
+    steps:
+      - id: plan-route
+        role: route_planner
+        description: Identify the verification root, command, target scope, and required artifacts.
+        prompt: |
+          Plan the authoritative verification route for $ARGUMENTS.
+          Read {{diagnosis_path}} when present.
+          Write {{route_plan_path}} with cwd, command, target files/routes, machine/log output, parsed summary, red classification, and skipped comparison requirements.
+          Do not assume the repository root is the runnable root.
+        checkpoints:
+          - assert: route_plan_written
+            command: "test -s \"{{route_plan_path}}\""
+            message: "Verification route plan must be written before route review."
+            action: block
+        handoff:
+          produces:
+            - type: file
+              path: "{{route_plan_path}}"
+              description: Proposed cwd, command, target scope, expected artifacts, and invalid-route risks.
+      - id: review-route
+        role: route_reviewer
+        depends_on: [plan-route]
+        description: Review the route before any command is run.
+        prompt: |
+          Review the verification route for $ARGUMENTS.
+          Read {{route_plan_path}}.
+          Reject wrong-root, stale-scope, missing-artifact, weak partial-run, or no-test-found routes.
+          Write {{route_verdict_path}} with APPROVE, REQUEST_CHANGES, or BLOCKED.
+        checkpoints:
+          - assert: route_verdict_written
+            command: "test -s \"{{route_verdict_path}}\""
+            message: "Verification route verdict must be written before command execution."
+            action: block
+        handoff:
+          consumes:
+            - type: file
+              path: "{{route_plan_path}}"
+              from: plan-route
+              description: Verification route plan.
+          produces:
+            - type: file
+              path: "{{route_verdict_path}}"
+              description: Reviewed route verdict and required changes.
+      - id: run-evidence
+        role: evidence_runner
+        depends_on: [review-route]
+        description: Run the reviewed command and capture canonical verification evidence.
+        prompt: |
+          Run the reviewed verification route for $ARGUMENTS.
+          Use {{route_plan_path}} and require APPROVE in {{route_verdict_path}} before running any command.
+          Capture command status, cwd, output, machine/log evidence, parsed summary, red classification, skipped comparison, and timestamps under {{evidence_dir}}.
+          If the route is invalid, classify the blocker instead of claiming success or failure.
+        handoff:
+          consumes:
+            - type: file
+              path: "{{route_plan_path}}"
+              from: plan-route
+              description: Approved verification route plan.
+            - type: file
+              path: "{{route_verdict_path}}"
+              from: review-route
+              description: Approved verification route verdict.
+          produces:
+            - type: file
+              path: "{{evidence_dir}}"
+              description: Routed verification evidence directory.
+      - id: manager-route
+        role: manager_reviewer
+        depends_on: [run-evidence]
+        description: Write manager-readable route decision for downstream completion/adoption/sync gates.
+        prompt: |
+          Write {{verification_summary_path}} for $ARGUMENTS.
+          Include target, cwd, command, status, blocker classification, evidence paths, counts, next commands, and updated_at.
+          State whether completion audit, adoption, rollout, evolution preview, or sync may proceed.
+        checkpoints:
+          - assert: verification_summary_written
+            command: "test -s \"{{verification_summary_path}}\""
+            message: "Verification summary must exist before completion audit or rollout decisions."
+            action: block
+        handoff:
+          consumes:
+            - type: file
+              path: "{{evidence_dir}}"
+              from: run-evidence
+              description: Verification evidence directory.
+          produces:
+            - type: file
+              path: "{{verification_summary_path}}"
+              description: Durable verification route summary.
+
+controllers:
+  verification-command-routing:
+    name: Verification Command Routing
+    description: "Route verification commands to the authoritative root/scope and capture canonical evidence before completion or rollout decisions."
+    kind: sequential
+    workflow: verification-command-routing
+    max_rounds: 1
+    progress_artifact_path: ".dna/verification-routing/$ARGUMENTS.controller.json"
+    roles:
+      route_planner: route_planner
+      route_reviewer: route_reviewer
+      evidence_runner: evidence_runner
+      manager_reviewer: manager_reviewer
+    stop_format: configured_stop_report

package/dist/workflow/authoring-packet.d.ts

@@ -0,0 +1,67 @@
+import { WORKFLOW_AUTHORING_SCHEMA } from "../schema/workflow-authoring-contract.js";
+export declare const AUTHORING_PACKET_SCHEMA_VERSION = "intentdna.authoring_packet.v1";
+export interface AuthoringPacketOptions {
+    goal?: string;
+    projectDir?: string;
+    generatedAt?: string;
+    exampleTemplates?: readonly string[];
+}
+export interface AuthoringPacketExample {
+    name: string;
+    display_name?: string;
+    source_path: string;
+    content_hash: string;
+    annotation: string;
+    c1_metadata: Record<string, unknown>;
+    workflow_keys: string[];
+    role_keys: string[];
+    yaml: string;
+}
+export interface AuthoringPacket {
+    schema_version: typeof AUTHORING_PACKET_SCHEMA_VERSION;
+    generated_at: string;
+    network_performed: false;
+    mutation_performed: false;
+    runtime_authority: false;
+    project_context: {
+        root: string;
+        handling: "local_path_only";
+        explicitly_requested: boolean;
+    };
+    goal_context?: {
+        raw: string;
+        handling: "opaque_context_only";
+        goal_modeling_performed: false;
+    };
+    asset_contract: {
+        source: string;
+        required_fields: readonly string[];
+        recommended_fields: readonly string[];
+        validation_required_fields: readonly string[];
+        validation_notes: readonly string[];
+        directory_protocol: {
+            builtin_templates: string;
+            project_templates: string;
+            candidate_staging: string;
+        };
+        compatibility: string[];
+    };
+    schema_constraints: typeof WORKFLOW_AUTHORING_SCHEMA;
+    red_lines: string[];
+    examples: AuthoringPacketExample[];
+    interview_protocol: Array<{
+        id: string;
+        question: string;
+        required_output: string;
+    }>;
+    validate_loop: Array<{
+        step: string;
+        command?: string;
+        owner: "external_agent" | "human" | "dna";
+        writes: boolean;
+        repeat_until?: string;
+    }>;
+    handoff_boundary: string[];
+    next_commands: string[];
+}
+export declare function buildAuthoringPacket(options?: AuthoringPacketOptions): Promise<AuthoringPacket>;