@sanity/ailf-studio 1.11.0 → 1.12.1

package/README.md

@@ -130,12 +130,12 @@ export default defineConfig({
 Tasks created in Studio are automatically included in every pipeline run — no
 registration step needed. There are four ways to execute tasks:
 
-| Method                         | Trigger                                                           | Scope                         |
-| ------------------------------ | ----------------------------------------------------------------- | ----------------------------- |
-| **Run Task Eval** action       | Click ▶ on any `ailf.task` document                               | Single task                   |
-| **Run AI Eval** release action | Click button on a content release page                            | Tasks affected by the release |
-| **CLI pipeline**               | `ailf pipeline` (with optional `--area`/`--task`/`--tag` filters) | All enabled tasks             |
-| **Scheduled pipeline**         | GitHub Actions cron (daily + weekly)                              | All enabled tasks             |
+| Method                         | Trigger                                                      | Scope                         |
+| ------------------------------ | ------------------------------------------------------------ | ----------------------------- |
+| **Run Task Eval** action       | Click ▶ on any `ailf.task` document                          | Single task                   |
+| **Run AI Eval** release action | Click button on a content release page                       | Tasks affected by the release |
+| **CLI**                        | `ailf run` (with optional `--area`/`--task`/`--tag` filters) | All enabled tasks             |
+| **Scheduled pipeline**         | GitHub Actions cron (daily + weekly)                         | All enabled tasks             |
 
 See the
 [CONTRIBUTING_TASKS](https://github.com/sanity-labs/ai-literacy-framework/blob/main/docs/contributing-tasks.md#running-your-task)
@@ -222,7 +222,7 @@ export default defineConfig({
 })
 ```
 
-Reports are written by the evaluation pipeline (`ailf pipeline --publish`).
+Reports are written by the evaluation pipeline (`ailf run --publish`).
 
 ## Exported API
 

package/dist/index.d.ts

@@ -1,10 +1,25 @@
 import * as sanity from 'sanity';
 import { DocumentActionComponent, ObjectInputProps, StringInputProps, ReleaseActionComponent, Tool } from 'sanity';
+import { StructureResolver, StructureBuilder } from 'sanity/structure';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { DocumentRef } from './document-ref.js';
 
+/**
+ * actions/ArchiveTaskAction.tsx
+ *
+ * Document action that sets `status: "archived"` on an ailf.task.
+ * Archived tasks are excluded from pipeline runs and hidden from the
+ * default Active view, but their history and report references are
+ * preserved.
+ *
+ * Only visible on tasks whose current `status` is not already "archived".
+ * The twin RestoreTaskAction handles the reverse transition.
+ */
+
+declare const ArchiveTaskAction: DocumentActionComponent;
+
 /**
  * actions/GraduateToNativeAction.tsx
  *
@@ -31,6 +46,16 @@ import { DocumentRef } from './document-ref.js';
 
 declare const GraduateToNativeAction: DocumentActionComponent;
 
+/**
+ * actions/RestoreTaskAction.tsx
+ *
+ * Document action that sets `status: "active"` on an archived ailf.task.
+ * Complements ArchiveTaskAction — only visible when the task's current
+ * `status` is "archived".
+ */
+
+declare const RestoreTaskAction: DocumentActionComponent;
+
 /**
  * actions/RunTaskEvaluationAction.tsx
  *
@@ -70,6 +95,46 @@ declare const GraduateToNativeAction: DocumentActionComponent;
  */
 declare const RunTaskEvaluationAction: DocumentActionComponent;
 
+/**
+ * structure.ts
+ *
+ * Structure helpers for the `ailf.task` document type. Exposes filtered
+ * list views so editors see only active tasks by default and can toggle
+ * into draft / paused / archived / all.
+ *
+ * ## Usage
+ *
+ * Replace your default structure with the one exported here:
+ *
+ * ```ts
+ * import { structureTool } from "sanity/structure"
+ * import { ailfStructure } from "@sanity/ailf-studio"
+ *
+ * export default defineConfig({
+ *   // ...
+ *   plugins: [ailfPlugin(), structureTool({ structure: ailfStructure })],
+ * })
+ * ```
+ *
+ * `ailfStructure` renders a filtered "AILF Tasks" entry in place of the
+ * default `ailf.task` list item and preserves every other document type
+ * at its Studio default. Consumers who already maintain a custom
+ * structure can splice just the list item in via `ailfTaskStructureItem`.
+ */
+
+/**
+ * Returns the filtered "AILF Tasks" list item. Splice this into an
+ * existing structure's `items()` array when the consumer already has
+ * their own structure resolver.
+ */
+declare function ailfTaskStructureItem(S: StructureBuilder): ReturnType<StructureBuilder["listItem"]>;
+/**
+ * Full structure resolver that replaces the default `ailf.task` entry
+ * with the filtered AILF Tasks item and keeps every other document
+ * type list item at its Studio default.
+ */
+declare const ailfStructure: StructureResolver;
+
 declare function AssertionInput(props: ObjectInputProps): react_jsx_runtime.JSX.Element;
 
 declare function CanonicalDocInput(props: ObjectInputProps): react_jsx_runtime.JSX.Element;
@@ -513,6 +578,14 @@ interface ArtifactRef {
     entries?: ArtifactRefEntry[];
     truncated?: boolean;
     preview?: unknown;
+    /**
+     * D0040 / W0135 — when present, this ref's bytes physically live under a
+     * different run's GCS prefix. `path` is already authoritative for
+     * resolution; this field is a lineage marker only. Studio mirror uses
+     * `string` rather than the branded `RunId` since Studio types deliberately
+     * avoid pulling in core's branded-IDs module.
+     */
+    sourceRunId?: string;
 }
 /** A single gap/recommendation from gap analysis */
 interface RecommendationGap {
@@ -1077,7 +1150,7 @@ declare const reportSchema: {
  *    the pipeline; score appears inline when complete (~10–15 min).
  * 2. **Run AI Eval** — click on a content release page. Auto-scopes to
  *    tasks whose canonical docs are in the release.
- * 3. **CLI** — `ailf pipeline --task <id>` or `ailf pipeline --area <area>`.
+ * 3. **CLI** — `ailf run --task <id>` or `ailf run --area <area>`.
  * 4. **Scheduled** — GitHub Actions cron (daily baseline, weekly full).
  *
  * Tasks can be authored natively in Studio or mirrored from external
@@ -1167,4 +1240,4 @@ declare function ailfTool(options?: AilfToolOptions): Tool;
  */
 declare const ailfPlugin: sanity.Plugin<void>;
 
-export { AssertionInput, CanonicalDocInput, type ComparisonData, type ContentImpactItem, GLOSSARY, GraduateToNativeAction, HelpDrawer, HelpProvider, type HelpTopic, MirrorBanner, type PerModelData, type ProvenanceData, ReleasePicker, type ReportDetail, type ReportListItem, type RunEvaluationActionOptions, RunTaskEvaluationAction, type ScoreItem, type SummaryData, SyncStatusBadge, type TimelineDataPoint, ailfPlugin, ailfTool, articleSearchQuery, comparisonPairQuery, contentImpactQuery, createRunEvaluationAction, deriveHelpTopic, distinctAreasQuery, distinctModesQuery, distinctPerspectivesQuery, distinctSourcesQuery, distinctTargetDocumentsQuery, distinctTriggersQuery, evalRequestSchema, featureAreaSchema, findTopic, latestReportsQuery, recentDocumentEvalsQuery, referenceSolutionSchema, reportDetailQuery, reportSchema, scoreTimelineQuery, searchTopics, taskSchema, useHelp, webhookConfigSchema };
+export { ArchiveTaskAction, AssertionInput, CanonicalDocInput, type ComparisonData, type ContentImpactItem, GLOSSARY, GraduateToNativeAction, HelpDrawer, HelpProvider, type HelpTopic, MirrorBanner, type PerModelData, type ProvenanceData, ReleasePicker, type ReportDetail, type ReportListItem, RestoreTaskAction, type RunEvaluationActionOptions, RunTaskEvaluationAction, type ScoreItem, type SummaryData, SyncStatusBadge, type TimelineDataPoint, ailfPlugin, ailfStructure, ailfTaskStructureItem, ailfTool, articleSearchQuery, comparisonPairQuery, contentImpactQuery, createRunEvaluationAction, deriveHelpTopic, distinctAreasQuery, distinctModesQuery, distinctPerspectivesQuery, distinctSourcesQuery, distinctTargetDocumentsQuery, distinctTriggersQuery, evalRequestSchema, featureAreaSchema, findTopic, latestReportsQuery, recentDocumentEvalsQuery, referenceSolutionSchema, reportDetailQuery, reportSchema, scoreTimelineQuery, searchTopics, taskSchema, useHelp, webhookConfigSchema };