@agent-native/creative-context 0.8.14 → 0.8.15-nightly-20260927013707

package/src/server/generation-artifact-record-role.spec.ts

@@ -67,7 +67,6 @@ const RANK = {
   owner: 4,
 } as const;
 
-/** Stand in for core's real role check, including its exact refusal wording. */
 function grantRole(role: keyof typeof RANK) {
   mocks.assertAccess.mockImplementation(
     async (resourceType: string, resourceId: string, minRole: string) => {
@@ -130,8 +129,6 @@ describe("generation provenance record role", () => {
       undefined,
       { skipResourceBody: true },
     );
-    // Recorded against the org, not the caller, so an editor reviewing the
-    // draft later still sees where it came from.
     expect(mocks.recordLocal).toHaveBeenCalledWith(
       draftRun,
       expect.objectContaining({

package/src/server/generation-context.ts

@@ -174,7 +174,6 @@ export interface ResolveGenerationCreativeContextInput {
   limit?: number;
   contextPackId?: string;
   contextPackSource?: "explicit" | "inherited";
-  /** Forwarded by isolated callers; local callers normally use app state. */
   selectedContextId?: string | null;
   contextModeOverride?: CreativeContextModeOverride;
 }

package/src/server/native-resource-capture.ts

@@ -1,6 +1,5 @@
 import type { NormalizedContextItem } from "../types.js";
 
-/** A native app resource reference supplied by a governed-context submission. */
 export interface NativeCreativeResourceRef {
   appId: string;
   resourceType: string;
@@ -11,10 +10,6 @@ export interface NativeCreativeResourceRef {
 export interface NativeResourceCaptureAdapter {
   appId: string;
   resourceType: string;
-  /**
-   * Reads only the version marker for resources visible to the active caller.
-   * The Library calls this once per resource type with at most 100 ids.
-   */
   listResourceVersions?(resourceIds: readonly string[]): Promise<
     Array<{
       resourceId: string;
@@ -29,14 +24,12 @@ export interface NativeResourceCaptureAdapter {
       externalRef?: string;
       upstreamAccess?: "available" | "restricted" | "unknown";
       containerOwnerVerifiedAt?: string;
-      /** Server-derived from the app's source resource; never client input. */
       access?: {
         visibility: "private" | "org" | "public";
         canManage: boolean;
       };
     };
     items: NormalizedContextItem[];
-    /** Persisted only as internal submission metadata; never action output. */
     privateMetadata?: Record<string, unknown>;
   }>;
 }
@@ -115,10 +108,6 @@ export function parseNativeCreativeArtifactKey(
   return resourceId ? { appId, resourceType, resourceId } : null;
 }
 
-/**
- * Resolves update availability in bounded batches. Missing rows are omitted so
- * an inaccessible native resource is indistinguishable from a deleted one.
- */
 export async function resolveNativeCreativeResourceUpdateStatuses(
   references: readonly PublishedNativeCreativeResourceRef[],
 ): Promise<Map<string, ResolvedNativeCreativeResourceUpdateStatus>> {

package/src/store/contexts.ts

@@ -181,7 +181,6 @@ function normalizedFromDetail(
     colors: detail.item.colors,
     provenance: detail.item.provenance,
     thumbnailBlobRef: detail.item.thumbnailBlobRef ?? undefined,
-    // Keep compiler/reassembly manifests while stripping capability-like metadata.
     metadata: (sanitizePublicMetadata(detail.version.metadata) ?? {}) as Record<
       string,
       unknown
@@ -559,7 +558,6 @@ export async function createCreativeContext(input: {
   return getCreativeContextById(id);
 }
 
-/** Idempotently establishes the actor's governed Default with the currently usable corpus. */
 export async function ensureDefaultCreativeContext(): Promise<CreativeContextSummary | null> {
   const { getDb, schema } = getCreativeContext();
   const actor = requireActor();
@@ -1018,12 +1016,6 @@ export async function listContextMemberships(input: {
   };
 }
 
-/**
- * Resolves private media for a pending submission without making the staged
- * item generally readable. This is intentionally server-only: callers must
- * already have an authenticated request context and can only read the exact
- * staged version they submitted or are allowed to review.
- */
 export async function readPendingCreativeContextMedia(input: {
   mediaId?: string;
   itemId?: string;

package/src/store/native-artifact-summary.ts

@@ -1,10 +1,6 @@
 import { nativeCreativeArtifactFromMetadata } from "../native-artifact.js";
 import type { ContextSearchResult } from "../types.js";
 
-/**
- * Search results advertise a retrievable artifact so a caller can tell that
- * get-context-item returns real code rather than only a text snippet.
- */
 export function nativeArtifactSummary(
   versionMetadata: unknown,
 ): ContextSearchResult["nativeArtifact"] {

package/src/types.ts

@@ -407,10 +407,6 @@ export interface ContextSearchResult {
   score: number;
   canonicalUrl: string | null;
   mimeType: string | null;
-  /**
-   * Present when the pinned version carries a native artifact, so a caller can
-   * tell that get-context-item returns real code rather than only a snippet.
-   */
   nativeArtifact: { app: string; format: string } | null;
 }
 
@@ -555,7 +551,6 @@ export interface CreativeContextMembershipPreview {
   preview?: Record<string, unknown>;
 }
 
-/** Public submission summary deliberately omits staging and native capability data. */
 export interface CreativeContextSubmissionSummary {
   id: string;
   contextId: string;