@intentic/extension-manifest 1.224.0 → 1.225.0

package/src/bundle.ts

@@ -30,12 +30,12 @@ export const bundleProblem = (source: string): string | undefined => {
     const specifiers = bundleSpecifiers(source);
     const relative = specifiers.filter((specifier) => specifier.startsWith(".") || specifier.startsWith("/"));
     if (relative.length > 0) {
-        return `imports a second file (${relative.join(", ")}) — a bundle is imported from a blob URL, so nothing relative to it can resolve`;
+        return `imports a second file (${relative.join(", ")}): a bundle is imported from a blob URL, so nothing relative to it can resolve`;
     }
     const published = new Set<string>(HOST_PUBLISHED_SPECIFIERS);
     const unpublished = specifiers.filter((specifier) => !published.has(specifier));
     if (unpublished.length > 0) {
-        return `imports ${unpublished.join(", ")}, which the host does not publish — bundle it in, or use one of: ${HOST_PUBLISHED_SPECIFIERS.join(", ")}`;
+        return `imports ${unpublished.join(", ")}, which the host does not publish, bundle it in, or use one of: ${HOST_PUBLISHED_SPECIFIERS.join(", ")}`;
     }
     return undefined;
 };

package/src/manifest.ts

@@ -20,7 +20,7 @@ export const ExtensionManifestSchema = z.object({
     publisher: z.string().regex(/^[a-z0-9][a-z0-9-]*$/),
     name: z.string().regex(/^[a-z0-9][a-z0-9-]*$/),
     // The extension's own semver, display/identity only; the installed code identity is the pinned commit sha.
-    version: z.string().min(1).describe("Your own semver — display and identity only. The installed code's identity is the pinned commit sha."),
+    version: z.string().min(1).describe("Your own semver, display and identity only. The installed code's identity is the pinned commit sha."),
     /* The section this extension sits under in the Sandbox hub's Extensions tab, a grouping by what it is FOR,
      * declared because it cannot be derived. Nine of the first-party extensions contribute a rail tile, so a
      * grouping read off `contributes` puts more than half the list in one section and says nothing about any of
@@ -32,7 +32,7 @@ export const ExtensionManifestSchema = z.object({
         .min(1)
         .optional()
         .describe(
-            "Which section of the Extensions tab this sits under — a grouping by what it is FOR, which cannot be derived from what it contributes. A section this app has never heard of lands in “Other” rather than failing to install.",
+            "Which section of the Extensions tab this sits under: a grouping by what it is FOR, which cannot be derived from what it contributes. A section this app has never heard of lands in 'Other' rather than failing to install.",
         ),
     /* What the extension is drawn as wherever it is LISTED rather than used, the Extensions tab, a registry
      * being browsed, the gallery. Deliberately here and not on a view: `Activation.icon` is the glyph of one
@@ -83,17 +83,17 @@ export const ExtensionManifestSchema = z.object({
             sandbox: z
                 .array(z.string())
                 .optional()
-                .describe("Daemon routes your UI half may call. Your own backend namespace needs no entry — its backend is your own code."),
+                .describe("Daemon routes your UI half may call. Your own backend namespace needs no entry: its backend is your own code."),
             daemon: z
                 .array(z.string())
                 .optional()
                 .describe(
-                    "Daemon routes your SERVER half may call. Separate from `sandbox` because the two halves run as different principals — the UI as the owner's session, the backend as a minted per-extension token — so a grant to one must never quietly widen the other.",
+                    "Daemon routes your SERVER half may call. Separate from `sandbox` because the two halves run as different principals: the UI as the owner's session, the backend as a minted per-extension token, so a grant to one must never quietly widen the other.",
                 ),
         })
         .optional()
         .describe(
-            'How far this extension may reach into the daemon, as "<METHOD> <path-glob>" entries where `*` matches one path segment — e.g. "GET /panels", "POST /panels/*/start". The install dialog shows these, the host refuses anything undeclared, and the usage ledger records which were actually earned.',
+            'How far this extension may reach into the daemon, as "<METHOD> <path-glob>" entries where `*` matches one path segment: e.g. "GET /panels", "POST /panels/*/start". The install dialog shows these, the host refuses anything undeclared, and the usage ledger records which were actually earned.',
         ),
     contributes: contributesSchema.optional(),
 });

package/src/mark.ts

@@ -50,7 +50,7 @@ export const MARK_FIELDS = {
         .max(ART_MAX_BYTES)
         .optional()
         .describe(
-            "This extension's own mark, as a complete SVG document inline — the tier an author controls fully. Give it a viewBox and let it fill its own square edge to edge; it is drawn as the tile, not as a glyph on a plate. Kept as readable SVG text (not base64) so a registry reviewer can see what they are publishing, drawn inert so it cannot script the page, and capped at 4 KB. Anything that does not parse as SVG falls back to `logo`, then `icon`, then initials.",
+            "This extension's own mark, as a complete SVG document inline: the tier an author controls fully. Give it a viewBox and let it fill its own square edge to edge; it is drawn as the tile, not as a glyph on a plate. Kept as readable SVG text (not base64) so a registry reviewer can see what they are publishing, drawn inert so it cannot script the page, and capped at 4 KB. Anything that does not parse as SVG falls back to `logo`, then `icon`, then initials.",
         ),
     // A simple-icons slug (https://cdn.simpleicons.org/<slug>). A "/<hex>" suffix forces a colour for marks
     // that vanish against the surface they land on (github's near-black).
@@ -58,13 +58,13 @@ export const MARK_FIELDS = {
         .string()
         .optional()
         .describe(
-            'A simple-icons slug, fetched from a CDN — right for standing in for somebody else\'s product. Add a "/<hex>" suffix to force a colour for a mark that vanishes against the surface it lands on. Unreachable in an offline sandbox, so it falls back to `icon`, then to initials.',
+            'A simple-icons slug, fetched from a CDN: right for standing in for somebody else\'s product. Add a "/<hex>" suffix to force a colour for a mark that vanishes against the surface it lands on. Unreachable in an offline sandbox, so it falls back to `icon`, then to initials.',
         ),
     // A name from the host's icon set (@intentic/ui IconName), drawn when no simple-icons slug fits.
     icon: z
         .string()
         .optional()
         .describe(
-            "A name from the host's own icon set, drawn when no simple-icons slug fits. It ships in the image, follows the theme and costs no request — what actually carries a first-party extension. An unknown name falls back to initials rather than to a hole.",
+            "A name from the host's own icon set, drawn when no simple-icons slug fits. It ships in the image, follows the theme and costs no request: what actually carries a first-party extension. An unknown name falls back to initials rather than to a hole.",
         ),
 };

package/src/permissions.ts

@@ -15,7 +15,7 @@ interface CompiledRoute {
 const compile = (entry: string): CompiledRoute => {
     const spaceIndex = entry.indexOf(" ");
     if (spaceIndex < 0) {
-        throw new Error(`invalid sandbox permission "${entry}" — expected "<METHOD> <path-glob>", e.g. "GET /panels"`);
+        throw new Error(`invalid sandbox permission "${entry}": expected "<METHOD> <path-glob>", e.g. "GET /panels"`);
     }
     const method = entry.slice(0, spaceIndex).trim().toUpperCase();
     const glob = entry.slice(spaceIndex + 1).trim();

package/src/points/automation-templates.ts

@@ -19,7 +19,7 @@ export const AutomationTemplateContributionSchema = z.object({
     id: z
         .string()
         .regex(/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/)
-        .describe('Prefills the automation name, and is what "does one of these exist already" is asked by — so spell it as an id, not as prose.'),
+        .describe('Prefills the automation name, and is what "does one of these exist already" is asked by, so spell it as an id, not as prose.'),
     title: z.string().min(1),
     logo: z.string().min(1).optional().describe("A simple-icons slug for the card."),
     icon: z.string().min(1).optional().describe("A name from the host's icon set, drawn when no simple-icons slug fits."),
@@ -29,7 +29,7 @@ export const AutomationTemplateContributionSchema = z.object({
         .array(z.string().min(1))
         .optional()
         .describe(
-            "Capability providers that make this template work — any one connected is enough (fixing CI rides github or gitlab). Omitted ⇒ nothing to connect, so it is always offered.",
+            "Capability providers that make this template work: any one connected is enough (fixing CI rides github or gitlab). Omitted ⇒ nothing to connect, so it is always offered.",
         ),
     // Shaped loosely here and parsed strictly at the merge: the manifest package cannot see the trigger union
     // (the dependency runs the other way), so the daemon is where a declaration meets the real schema.
@@ -48,7 +48,7 @@ export const AutomationTemplateContributionSchema = z.object({
         .string()
         .min(1)
         .optional()
-        .describe("A condition that must hold before the turn runs — what makes a template safe to leave switched on."),
+        .describe("A condition that must hold before the turn runs: what makes a template safe to leave switched on."),
     holdForSeconds: z.number().int().positive().optional().describe("Wait this long and coalesce repeats, rather than firing on every event."),
     prompt: z.string().min(1).describe("The turn this starts. You own the trigger's payload vocabulary, so you own the prompt that reads it."),
     note: z.string().min(1).optional(),
@@ -63,7 +63,7 @@ export const AutomationTemplateContributionSchema = z.object({
         .enum(["create", "configure"])
         .optional()
         .describe(
-            "Absent ⇒ it waits in the gallery, where you go once you know what you want. `create` puts a card on the page that makes it, switched off, in one click. `configure` puts one there that opens the dialog prefilled, for a template that cannot work unconfigured. Both are for what a user would never think to go looking for — mark everything as offered and you have rebuilt the gallery with extra steps.",
+            "Absent ⇒ it waits in the gallery, where you go once you know what you want. `create` puts a card on the page that makes it, switched off, in one click. `configure` puts one there that opens the dialog prefilled, for a template that cannot work unconfigured. Both are for what a user would never think to go looking for: mark everything as offered and you have rebuilt the gallery with extra steps.",
         ),
     // Whether what this makes watches THIS codebase (the chores shelf) rather than the outside world. Declared
     // rather than read off the trigger: a nightly dependency sweep and a nightly Stripe poll are both schedules.
@@ -71,7 +71,7 @@ export const AutomationTemplateContributionSchema = z.object({
         .boolean()
         .optional()
         .describe(
-            "Whether what this makes watches THIS codebase rather than the outside world. Declared rather than read off the trigger — a nightly dependency sweep and a nightly Stripe poll are both schedules.",
+            "Whether what this makes watches THIS codebase rather than the outside world. Declared rather than read off the trigger: a nightly dependency sweep and a nightly Stripe poll are both schedules.",
         ),
 });
 export type AutomationTemplateContribution = z.infer<typeof AutomationTemplateContributionSchema>;
@@ -79,6 +79,6 @@ export type AutomationTemplateContribution = z.infer<typeof AutomationTemplateCo
 export const automationTemplatesPoint = {
     name: "automationTemplates",
     description:
-        "Starting points this pack offers in the automation composer — a trigger, a prompt written for that trigger's payload, and whatever guard makes it safe to leave on. Declared by whoever knows the service rather than by the composer, so they appear when your pack is installed and disappear with it. Pure prefill: creating one makes an ordinary automation.",
+        "Starting points this pack offers in the automation composer, a trigger, a prompt written for that trigger's payload, and whatever guard makes it safe to leave on. Declared by whoever knows the service rather than by the composer, so they appear when your pack is installed and disappear with it. Pure prefill: creating one makes an ordinary automation.",
     schema: z.array(AutomationTemplateContributionSchema),
 } as const satisfies ContributionPoint;

package/src/points/bin.ts

@@ -7,7 +7,7 @@ import type { ContributionPoint } from "../contribution-point.js";
 export const binPoint = {
     name: "bin",
     description:
-        "A checkout-relative directory of executables the daemon puts on the agent's PATH every turn — how you ship the agent a command-line tool. The files are the approved code themselves: they ride the pinned checkout, and the daemon only adds the directory to PATH.",
+        "A checkout-relative directory of executables the daemon puts on the agent's PATH every turn, how you ship the agent a command-line tool. The files are the approved code themselves: they ride the pinned checkout, and the daemon only adds the directory to PATH.",
     schema: z
         .string()
         .min(1)

package/src/points/capabilities.ts

@@ -32,7 +32,7 @@ export const CapabilityFieldSchema = z.object({
         .string()
         .optional()
         .describe(
-            "A line under this control, for what the label alone cannot say — a host requirement, when a value takes effect. The card's own `hint` speaks for the whole card; this one is bound to the field it qualifies.",
+            "A line under this control, for what the label alone cannot say: a host requirement, when a value takes effect. The card's own `hint` speaks for the whole card; this one is bound to the field it qualifies.",
         ),
     /* This field's value only takes effect after the sandbox is REBUILT, it rides the environment overlay
      * rather than something the daemon can act on now. Rendered as a chip beside the label.
@@ -45,7 +45,7 @@ export const CapabilityFieldSchema = z.object({
         .boolean()
         .optional()
         .describe(
-            "This value only takes effect after the sandbox is rebuilt, because it rides the image overlay. Shown as a chip beside the label — two switches side by side, identical in every visible way, can otherwise cost five seconds or five minutes with no way to tell which.",
+            "This value only takes effect after the sandbox is rebuilt, because it rides the image overlay. Shown as a chip beside the label: two switches side by side, identical in every visible way, can otherwise cost five seconds or five minutes with no way to tell which.",
         ),
     default: z.string().optional(),
     options: z
@@ -64,7 +64,7 @@ export const CapabilityFieldSchema = z.object({
         .refine(isWhenExpression, { message: "not a valid `when` condition" })
         .optional()
         .describe(
-            "Only show this field while a condition over the answers already given holds — `auth == 'key'`, `provider in ['ipsec', 'fortinet']`, `!advanced`. Supports `&&`, `||`, `!`, comparisons and `in`.",
+            "Only show this field while a condition over the answers already given holds: `auth == 'key'`, `provider in ['ipsec', 'fortinet']`, `!advanced`. Supports `&&`, `||`, `!`, comparisons and `in`.",
         ),
     // A fixed value baked into the config rather than asked for, how a card pins a discriminator
     // (platform="reddit", provider="stripe"). Rendered as nothing; sent as itself.
@@ -72,7 +72,7 @@ export const CapabilityFieldSchema = z.object({
         .string()
         .optional()
         .describe(
-            'A fixed value baked into the config rather than asked for — how a card pins its discriminator (platform="reddit", provider="stripe"). Renders as nothing.',
+            'A fixed value baked into the config rather than asked for: how a card pins its discriminator (platform="reddit", provider="stripe"). Renders as nothing.',
         ),
     /* This field holds a TOTP seed, the base32 key (or otpauth:// URI) a service shows when enrolling an
      * authenticator app. Declare it WITH `secret: true`: the seed is a durable second factor, so it is never
@@ -83,7 +83,7 @@ export const CapabilityFieldSchema = z.object({
         .boolean()
         .optional()
         .describe(
-            "This field holds a TOTP seed — the base32 key or otpauth:// URI a service shows when enrolling an authenticator app. Declare it with `secret: true`. Unlike an ordinary secret it never enters the agent's environment: the daemon mints the six-digit codes on demand and only those cross.",
+            "This field holds a TOTP seed, the base32 key or otpauth:// URI a service shows when enrolling an authenticator app. Declare it with `secret: true`. Unlike an ordinary secret it never enters the agent's environment: the daemon mints the six-digit codes on demand and only those cross.",
         ),
 });
 export type CapabilityField = z.infer<typeof CapabilityFieldSchema>;
@@ -118,7 +118,7 @@ const CatalogSchema = z.object({
         .string()
         .min(1)
         .describe(
-            "ONE LINE — aim for 60 characters or fewer. The grid clamps it at two lines in a narrow pane, so a paragraph here is a paragraph the reader gets truncated. Everything longer belongs in `hint`.",
+            "ONE LINE: aim for 60 characters or fewer. The grid clamps it at two lines in a narrow pane, so a paragraph here is a paragraph the reader gets truncated. Everything longer belongs in `hint`.",
         ),
     category: z.string().min(1),
     // The paragraph. Shown under the add-form, and searched from the catalog, so the words that identify this
@@ -127,7 +127,7 @@ const CatalogSchema = z.object({
         .string()
         .optional()
         .describe(
-            'The paragraph, shown under the add form and searched from the catalog — so the words that identify this card to someone hunting for it ("webauthn", "socket mode") belong here even when the tile cannot show them.',
+            'The paragraph, shown under the add form and searched from the catalog, so the words that identify this card to someone hunting for it ("webauthn", "socket mode") belong here even when the tile cannot show them.',
         ),
     // The credential-creation walkthrough the install dialog renders (the platform catalog's guide shape).
     guide: z
@@ -177,7 +177,7 @@ export const CapabilityContributionSchema = z
             env: z
                 .record(z.string().regex(/^[A-Z][A-Z0-9_]*$/), z.string())
                 .describe(
-                    "The environment the agent's shell gets, as value templates over the fields — `${field}` substitutes, `${field:uri}` percent-encodes. Each name is suffixed per instance.",
+                    "The environment the agent's shell gets, as value templates over the fields: `${field}` substitutes, `${field:uri}` percent-encodes. Each name is suffixed per instance.",
                 ),
             skill: z
                 .string()
@@ -211,19 +211,19 @@ export const CapabilityContributionSchema = z
                 .url()
                 .optional()
                 .describe(
-                    "What the sign-in window opens; the profile it persists IS the credential. Optional so one card can be the generic one that asks for the URL on its form instead — but a card must either pin this or declare a field that supplies it, or the window opens on nothing.",
+                    "What the sign-in window opens; the profile it persists IS the credential. Optional so one card can be the generic one that asks for the URL on its form instead, but a card must either pin this or declare a field that supplies it, or the window opens on nothing.",
                 ),
             homeUrl: z
                 .url()
                 .optional()
                 .describe(
-                    "Where that same profile opens once it HAS a session — the owner's own hands on the connected browser. Separate from loginUrl because for some platforms the login lives on another site entirely (YouTube signs in at accounts.google.com).",
+                    "Where that same profile opens once it HAS a session: the owner's own hands on the connected browser. Separate from loginUrl because for some platforms the login lives on another site entirely (YouTube signs in at accounts.google.com).",
                 ),
             skill: z
                 .string()
                 .min(1)
                 .describe(
-                    "Checkout-relative SKILL.md teaching the agent this site's actions — rendered once per site, all its connected accounts on one roster (`${accounts}`), the core tool note at `${tools}`.",
+                    "Checkout-relative SKILL.md teaching the agent this site's actions: rendered once per site, all its connected accounts on one roster (`${accounts}`), the core tool note at `${tools}`.",
                 ),
         }),
         // An operating system a connected computer can run, the skill pack that teaches the agent THAT machine's
@@ -249,7 +249,7 @@ export const CapabilityContributionSchema = z
             if (Object.values(spec.env).some((template) => template.includes(`\${${field.key}}`) || template.includes(`\${${field.key}:uri}`))) {
                 ctx.addIssue({
                     code: "custom",
-                    message: `env must not reference the totp field "${field.key}" — the daemon mints codes from it instead`,
+                    message: `env must not reference the totp field "${field.key}", the daemon mints codes from it instead`,
                 });
             }
         }
@@ -275,6 +275,6 @@ export const contributionDiscriminator = (kind: string): string | undefined => D
 export const capabilitiesPoint = {
     name: "capabilities",
     description:
-        'Capability cards this pack adds to the "+" grid — a connected CLI tool, a site the agent acts on as the owner through the shared browser, an operating system pack, or a preset over a core kind. The card and its form are data here; the machinery that acts on them is core, which is why a card may only name one of these four kinds.',
+        'Capability cards this pack adds to the "+" grid: a connected CLI tool, a site the agent acts on as the owner through the shared browser, an operating system pack, or a preset over a core kind. The card and its form are data here; the machinery that acts on them is core, which is why a card may only name one of these four kinds.',
     schema: z.array(CapabilityContributionSchema),
 } as const satisfies ContributionPoint;

package/src/points/commands.ts

@@ -31,7 +31,7 @@ export const CommandContributionSchema = z.object({
         .refine(isWhenExpression, { message: "not a valid `when` condition" })
         .optional()
         .describe(
-            "When the shortcut applies, as a condition over the shell's context keys — `tabSurface == 'chat'`, `!editableTarget`. Without one the chord is claimed everywhere, including inside a terminal where a bare key belongs to the program running in it. The command palette ignores this: a command is always runnable by name.",
+            "When the shortcut applies, as a condition over the shell's context keys, `tabSurface == 'chat'`, `!editableTarget`. Without one the chord is claimed everywhere, including inside a terminal where a bare key belongs to the program running in it. The command palette ignores this: a command is always runnable by name.",
         ),
 });
 export type CommandContribution = z.infer<typeof CommandContributionSchema>;

package/src/points/environment.ts

@@ -11,7 +11,7 @@ export const EnvironmentContributionSchema = z.object({
         .min(1)
         .refine((value) => !value.split("/").includes(".."), { message: "fragment must stay inside the checkout" })
         .describe(
-            "Checkout-relative path to a file holding ONLY RUN and ENV instructions. FROM and privileged directives are rejected — those stay daemon-owned.",
+            "Checkout-relative path to a file holding ONLY RUN and ENV instructions. FROM and privileged directives are rejected: those stay daemon-owned.",
         ),
 });
 export type EnvironmentContribution = z.infer<typeof EnvironmentContributionSchema>;
@@ -19,6 +19,6 @@ export type EnvironmentContribution = z.infer<typeof EnvironmentContributionSche
 export const environmentPoint = {
     name: "environment",
     description:
-        "A Dockerfile fragment baked into the sandbox image so your tools are actually installed at runtime — a whisper binary, a psql client. The owner approves the composed overlay and rebuilds out of band, so this does not take effect immediately.",
+        "A Dockerfile fragment baked into the sandbox image so your tools are actually installed at runtime: a whisper binary, a psql client. The owner approves the composed overlay and rebuilds out of band, so this does not take effect immediately.",
     schema: EnvironmentContributionSchema,
 } as const satisfies ContributionPoint;

package/src/points/files.ts

@@ -27,7 +27,7 @@ export const FileContributionSchema = z.object({
             message: "path must be workspace-root-relative and stay inside the workspace",
         })
         .describe(
-            "Workspace-root-relative, forward-slash, matched by prefix — so one entry covers an exact file (`.intentic/config/automations.json`), a directory (`.intentic/config/drafts/`, with the trailing slash so it cannot match a sibling file) or a name family (`.intentic/environment.`). Not a glob.",
+            "Workspace-root-relative, forward-slash, matched by prefix, so one entry covers an exact file (`.intentic/config/automations.json`), a directory (`.intentic/config/drafts/`, with the trailing slash so it cannot match a sibling file) or a name family (`.intentic/environment.`). Not a glob.",
         ),
     /* The browser query keys those contents feed, the first element of the extension's own
      * `api.sandbox.key(...)` keys, which is what makes them match (the sandbox id is a SUFFIX). Empty is not
@@ -41,7 +41,7 @@ export const FileContributionSchema = z.object({
         .array(z.string().min(1))
         .min(1)
         .describe(
-            "The query keys this path makes stale — the first element of your own api.sandbox.key(...) keys. Keep both this and the path as narrow as the view actually needs: a broad prefix costs every connected browser a refetch on every matching write.",
+            "The query keys this path makes stale, the first element of your own api.sandbox.key(...) keys. Keep both this and the path as narrow as the view actually needs: a broad prefix costs every connected browser a refetch on every matching write.",
         ),
 });
 export type FileContribution = z.infer<typeof FileContributionSchema>;

package/src/points/listener.ts

@@ -54,12 +54,12 @@ export const ListenerContributionSchema = z.object({
                 .describe(
                     "Only for a source whose message events distinguish being addressed. Absent ⇒ the editor offers no mention-only filter, rather than inventing semantics you did not promise.",
                 ),
-            channel: TriggerFieldContributionSchema.describe("The primary narrowing filter — a channel, a room, a repo."),
+            channel: TriggerFieldContributionSchema.describe("The primary narrowing filter, a channel, a room, a repo."),
             // A SECOND narrowing axis, for a source whose events carry one, a pipeline's git ref, so a trigger can
             // say "the branch that ships" rather than "every agent's every failure". Absent ⇒ the editor offers
             // only the channel filter.
             branchField: TriggerFieldContributionSchema.optional().describe(
-                'A second narrowing axis, for a source whose events carry one — a pipeline\'s git ref, so a trigger can say "the branch that ships" rather than "every agent\'s every failure".',
+                'A second narrowing axis, for a source whose events carry one: a pipeline\'s git ref, so a trigger can say "the branch that ships" rather than "every agent\'s every failure".',
             ),
             // The provider owns the payload vocabulary, so it also owns the first prompt that explains that payload.
             starterPrompt: z
@@ -76,6 +76,6 @@ export type ListenerContribution = z.infer<typeof ListenerContributionSchema>;
 export const listenerPoint = {
     name: "listener",
     description:
-        "A realtime event source this extension supplies, so automations can trigger on it. One declaration feeds both halves: the daemon accepts these event types and serves this provider's control surface, and the automation editor derives its source picker, filters and starter prompt from it — so a newly installed listener is configurable without a matching app release.",
+        "A realtime event source this extension supplies, so automations can trigger on it. One declaration feeds both halves: the daemon accepts these event types and serves this provider's control surface, and the automation editor derives its source picker, filters and starter prompt from it, so a newly installed listener is configurable without a matching app release.",
     schema: ListenerContributionSchema,
 } as const satisfies ContributionPoint;

package/src/points/processes.ts

@@ -15,6 +15,6 @@ export type ProcessContribution = z.infer<typeof ProcessContributionSchema>;
 export const processesPoint = {
     name: "processes",
     description:
-        "Long-lived background processes the daemon runs for this extension — a gateway holding a connection the daemon must not, a dev server. Managed the same way panel dev servers are, and startable and stoppable from the Extensions tab.",
+        "Long-lived background processes the daemon runs for this extension: a gateway holding a connection the daemon must not, a dev server. Managed the same way panel dev servers are, and startable and stoppable from the Extensions tab.",
     schema: z.array(ProcessContributionSchema),
 } as const satisfies ContributionPoint;

package/src/points/settings.ts

@@ -12,7 +12,7 @@ export const SettingContributionSchema = z.object({
     secret: z
         .boolean()
         .optional()
-        .describe("Mask the value in the UI and strip it from reads — a set secret round-trips as “still set”, never as its value."),
+        .describe("Mask the value in the UI and strip it from reads: a set secret round-trips as 'still set', never as its value."),
     env: z
         .string()
         .regex(/^[A-Z][A-Z0-9_]*$/)

package/src/points/viewers.ts

@@ -10,7 +10,7 @@ export const ViewerContributionSchema = z.object({
     extensions: z
         .array(z.string().regex(/^[a-z0-9]+$/))
         .min(1)
-        .describe('Bare file extensions, no dot — e.g. ["docx", "xlsx"].'),
+        .describe('Bare file extensions, no dot: e.g. ["docx", "xlsx"].'),
     /* `fetch` is how much of the file the host puts in the extension's hands, and it is a real choice:
      *   text, decoded utf8 (`text` prop). For a format that IS text: svg, a subtitle track, a notebook.
      *   blob, the whole file in memory (`blob` prop). For a format that must be parsed end to end before any of
@@ -23,7 +23,7 @@ export const ViewerContributionSchema = z.object({
     fetch: z
         .enum(["text", "blob", "url"])
         .describe(
-            "How much of the file the host hands you. `text` for a format that is text (svg, a subtitle track). `blob` for one that must be parsed end to end before any of it shows (a .docx, a spreadsheet) — bounded by the daemon's raw-read cap. `url` for anything range-read rather than parsed (audio, video): your component gets a streaming URL to point an element at, never the bytes.",
+            "How much of the file the host hands you. `text` for a format that is text (svg, a subtitle track). `blob` for one that must be parsed end to end before any of it shows (a .docx, a spreadsheet), bounded by the daemon's raw-read cap. `url` for anything range-read rather than parsed (audio, video): your component gets a streaming URL to point an element at, never the bytes.",
         ),
 });
 export type ViewerContribution = z.infer<typeof ViewerContributionSchema>;
@@ -31,6 +31,6 @@ export type ViewerContribution = z.infer<typeof ViewerContributionSchema>;
 export const viewersPoint = {
     name: "viewers",
     description:
-        "File formats this extension can render. The host resolves an opened file to your viewer by its extension, fetches the content, and renders your component with it — you keep none of the fetch lifecycle and none of the daemon credentials.",
+        "File formats this extension can render. The host resolves an opened file to your viewer by its extension, fetches the content, and renders your component with it: you keep none of the fetch lifecycle and none of the daemon credentials.",
     schema: z.array(ViewerContributionSchema),
 } as const satisfies ContributionPoint;