@agentville/bridge 0.0.0-stage → 0.2.1

package/dist/skills/impeccable/LICENSE

@@ -0,0 +1,191 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright
+      owner or by an individual or Legal Entity authorized to submit on
+      behalf of the copyright owner. For the purposes of this definition,
+      "submitted" means any form of electronic, verbal, or written
+      communication sent to the Licensor or its representatives, including
+      but not limited to communication on electronic mailing lists, source
+      code control systems, and issue tracking systems that are managed by,
+      or on behalf of, the Licensor for the purpose of discussing and
+      improving the Work, but excluding communication that is conspicuously
+      marked or otherwise designated in writing by the copyright owner as
+      "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 Paul Bakaus
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/skills/impeccable/NOTICE

@@ -0,0 +1,7 @@
+This skill is adapted from Impeccable 4.0.4 (https://github.com/pbakaus/impeccable),
+Copyright 2025 Paul Bakaus, licensed under the Apache License, Version 2.0
+(see LICENSE in this folder).
+
+Changes: AgentVille rewrote SKILL.md and agents/openai.yaml for its
+generated-app workspace (autonomous app building for people who do not
+code). It is not the upstream skill and is not endorsed by its author.

package/dist/skills/impeccable/SKILL.md

@@ -0,0 +1,149 @@
+---
+name: impeccable
+description: Plan, build, and independently review exceptional visual interfaces inside the Loopers generated-app workspace. Use for new sites, apps, dashboards, tools, games, redesigns, and any frontend where art direction, imagery, typography, hierarchy, interaction, responsiveness, or final screenshot quality materially affects the result.
+---
+
+# Impeccable for Loopers
+
+Adapt Impeccable 4.0.4's final-state design discipline to an autonomous,
+non-coder app-building environment. Make the decisions the user did not name.
+Do not turn a short request into an art-direction interview, an approval
+ceremony, or a design contract stored in the app.
+
+## Decide the finished experience before writing it
+
+Infer a compact internal direction from the request and any existing project:
+
+- the user's real task or desired feeling;
+- the visual world and why it belongs to this subject;
+- the first viewport's composition and focal point;
+- the interaction or story that carries the experience;
+- the dominant assets, typography, color, and motion system;
+- the desktop and mobile structures, including RTL when relevant.
+
+A descriptive reference such as "Sonic-like," "luxury hotel," or "clinic
+dashboard" is meaningful input. Preserve the reference's useful qualities while
+creating an original result. Ask only about missing facts that would materially
+change function, content, or safety. Choose the remaining design direction
+yourself.
+
+Build toward that final direction from the first workspace write. A first
+render may be incomplete, but it must use the intended composition, asset
+strategy, component language, and responsive structure. Do not create a
+throwaway scaffold whose visual system will be replaced later.
+
+## Match expression to the surface
+
+- **Persuade:** landing pages, campaigns, pricing, and public destinations.
+  Earn attention and action with specific composition, proof, and real imagery
+  when imagery carries the promise.
+- **Operate:** dashboards, editors, admin, forms, trackers, and tools. Favor
+  scanability, task flow, complete states, and familiar controls. Images are
+  optional; precise structure and one consistent component vocabulary are not.
+- **Read:** articles, docs, reports, and guides. Design for comprehension,
+  hierarchy, navigation, and a comfortable reading rhythm.
+- **Experience:** games, portfolios, galleries, and showcases. Let the artifact,
+  world, or interaction lead from the first viewport.
+
+## Choose assets before implementation
+
+Identify the two or three visual elements that will dominate the finished
+screens. Decide how each will be made before writing the surface. Classify
+characters, hero subjects, featured products, landmarks, cover art, and other
+tangible focal pieces as identity-bearing artwork rather than UI geometry:
+
+1. Generate original art with `generate_image` when a bespoke, fictional,
+   stylized, fantastical, editorial, or brand-safe hero, world, background,
+   texture, or character study will carry the identity. Choose dimensions for
+   its actual crop and use a seed or reference image when consistency matters.
+2. Call `search_images` before generation for an existing real-world
+   photograph, historical image, named place, named product, documentary
+   reference, public-domain work, stock-like scene, or other visual whose value
+   comes from authentic source pixels, unless the user explicitly requested a
+   generated interpretation. Preview the returned contact sheet, select
+   deliberately, then use `download_image` to bundle the chosen original; it
+   writes and durably registers the required credit block automatically.
+3. Use `download_asset` for an exact licensed file already found on an approved
+   package, font, GitHub, or Wikimedia source.
+4. Use authored SVG, CSS, canvas, or procedural art when the medium itself
+   supports the direction. It must read as genuinely drawn or deliberately
+   abstract at its final scale; assembling a focal character or hero from a few
+   generic primitives is still placeholder art.
+
+For image-led surfaces, default important tangible subjects to real or generated
+primary artwork. Do not substitute emoji, generic gradients, UI chrome, or a few
+glowing primitives for a visual world. Primitives remain appropriate for
+interface structure, icons, charts, collision geometry, particles, lighting,
+and supporting effects. For task-led product UI, do not add irrelevant stock
+photography merely to prove an asset tool was called.
+
+Treat commercial reuse as the safe default. Use noncommercial search only when
+the user explicitly establishes a personal or noncommercial purpose and the
+planned distribution fits that license. Respect attribution, adaptation,
+share-alike, personality, trademark, and other rights. Record every external
+asset in `ASSET_CREDITS.md` and keep it bundle-local.
+
+## Build at the craft floor
+
+- Use a coherent type scale and no more than three font families. Keep body
+  text readable and functional text at least 11px.
+- Use color as a system with sufficient contrast, not as scattered decoration.
+- Make hierarchy visible through composition, scale, alignment, density, and
+  whitespace before adding cards or borders.
+- Give every control the relevant default, hover, focus, active, disabled,
+  loading, error, empty, and success behavior.
+- Make responsive behavior structural. Recompose for portrait screens instead
+  of shrinking or letterboxing a desktop surface.
+- Make motion explain state, causality, or spatial change. Respect reduced
+  motion.
+- Refuse generic AI tells: identical card grids, emoji icon systems, gradient
+  text, decorative glass, excessive rounding, giant empty panels, tiny tracked
+  eyebrows, placeholder copy, and unintentional cream-on-gray sameness.
+- Reject primitive-built focal subjects when the direction calls for a tangible
+  character, object, place, or illustration. Replace them with generated,
+  licensed, or genuinely authored artwork instead of polishing the surrounding
+  UI to distract from a missing identity asset.
+- Keep factual content honest. Do not invent businesses, testimonials, contact
+  details, metrics, or claims.
+
+## Finish with independent evidence
+
+Judge the planned direction early without substituting a throwaway checkpoint
+for the final design. Once the identity-carrying assets, intended composition,
+responsive structure, and primary interaction are representative, preview
+desktop and mobile together and correct a wrong direction before filling every
+secondary state. Then complete the candidate and:
+
+When trusted runtime instructions declare standard app delivery for an app or
+site, use its focused policy: exercise a complete desktop and mobile journey,
+capture meaningful states, fix blocking evidence in coherent batches, and preview
+every changed exact bundle. Then obtain the required `visual_finish_reviewer`
+pass using the retained captures and deliver immediately. The reviewer drives
+only missing or ambiguous states. Do not impose a fixed preview count or continue
+polishing after the exact bundle passes. Every
+game, plus high-complexity apps and sites, keeps the independent sequence below.
+
+1. Preview desktop and mobile together and exercise the primary interaction.
+2. Delegate a focused final review to `visual_finish_reviewer`. Give it the app
+   directory, the inferred final direction, the user's goal, and the states it
+   should exercise. Do not give it your own verdict. The reviewer must record
+   `needs_changes` for blocking findings or `passed` for the exact final preview
+   fingerprint; a merely registered or delegated reviewer is not completion
+   evidence.
+3. Fix the returned high-impact defects in one coherent batch. Rework weak
+   assets or composition instead of applying cosmetic patches to the wrong
+   direction.
+4. Preview the exact bundle once more in its entry and interacted states. If
+   craft, responsiveness, interaction, or runtime evidence still fails, fix
+   the remaining high-impact defects and repeat review and preview until it
+   passes.
+
+The reviewer advises; the parent agent owns edits and delivery. Use `task` with
+`agent: "visual_finish_reviewer"` and a concise `prompt` giving the directory,
+exact preview fingerprint, user goal, intended direction, and acceptance states.
+Do not paste source, screenshots, base64, transcripts, or whole receipts into it.
+If delegation fails, correct its reported cause; do not replay preview or edit
+the app merely to retry a failed launch. If independent review remains unavailable,
+report the blocker. Self-review cannot create its required host attestation.
+Never claim visual review without
+actual screenshot pixels.

package/dist/skills/impeccable/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Impeccable for Loopers"
+  short_description: "Plan and review exceptional generated-app design"
+  default_prompt: "Use $impeccable to plan, build, and independently review a polished visual experience for my request."