Penumbra · Product updates
Changelog.
New ways to work with what you know.
87 updates
ImprovedArea: ExtractionExtract from a document and the files it embeds
When a Markdown document embeds pictures or other files from your project, extraction now reads them in the same run. The plan shows which embedded files were included or left out, and each finding cites the file it came from. Embedded files count toward the run’s usual limits.
Extracting from filesFixedArea: GraphSubmitted changes land together or not at all
When you submit a workspace, its record changes, relationships, and citations are now applied together. If the submission can’t finish, nothing from it is kept and the workspace stays open to try again. If it finished but the reply was lost, submitting it again returns the saved result. A submission left partly applied before this change still needs to be resumed.
ImprovedArea: FilesKeep a page’s text when its capture runs into trouble
If saving a public web page times out or hits certain page errors, Penumbra now tries a second way to read its text. When that works, the page is saved to the same file, without a screenshot. The site’s crawling rules still apply, and pages that need scripts to show their content may still fail.
Saving web pagesImprovedArea: FilesKeep the publication date a page states
Saved web pages now pick up publication dates from more places, including the page’s structured data and the article’s dateline. The result notes where the date came from, so a workflow can use the date the page gives. A page with no date stays undated.
Saving web pagesNewArea: WorkflowsSave web pages as a workflow step
A workflow can now save a list of public web pages, wait for them to finish, and pass the saved files to its next step. Each address gets its own result, with a reason if it couldn’t be saved. You decide what happens next when only some pages arrive.
Writing a workflowNewArea: WorkflowsMake one step wait for another
Give a workflow step an “after” list to make it wait for earlier steps, even when it doesn’t use their output. For example, a submission can wait until every item in a batch is staged. If a step it waits for fails, is refused, or is skipped, the waiting step is skipped too.
Writing a workflowFixedArea: WorkflowsUse a long job’s finished result in the next step
When a step starts a job that takes a while, later steps can now refer to the result the job returns when it finishes. Workflow checks no longer reject those references for naming fields that only appear in the finished result. A reference through an optional result that comes back empty no longer fails with a path error.
Writing a workflowFixedArea: GraphRecords you add by hand keep their dates
Records you stage yourself or through a workflow now carry the event and deadline dates their Shape defines, plus the source dates from their citations. Editing the values or citations before you submit updates those dates. An event or deadline can be kept without citing a file, and an unknown source date stays unknown.
Adding facts by handImprovedArea: GraphPick the exact type when two Shapes share a name
When you stage a new record, you can now name its type by its type ID as well as its name. If two Shapes both define a Person, the ID picks the one you mean. A workflow can also pass a type ID straight into its staging step.
Adding facts by handFixedArea: GraphKeep reading records after your Shape grows
With the updated SDK, a client generated from an earlier version of a Shape can read compatible records saved under a newer version. A record the client can’t read is reported on its own, so it no longer stops the rest of a list from loading. Your app can use the readable results and handle the exceptions.
Domain ModeNewArea: WorkflowsPropose record changes from a workflow
A workflow can now open a workspace, stage new records, bring in existing ones, and edit the proposed changes, using output from earlier steps. Submitting the changes is a separate step. Every step stays within the workflow’s project and permissions.
Writing a workflowFixedArea: WorkflowsWorkflows can start the extractions you’re allowed to run
An extraction step now gets permission to spend credits when the person who started the workflow has that permission in the project. This fixes runs that were refused even though their owner could run the extraction. The permission ends when the run finishes or is stopped.
Writing a workflowFixedArea: WorkflowsRun the file organizer from a workflow
A workflow’s organizing step can now read the file text, collections, and existing names it needs. This fixes a permission error that stopped the step even when the file was ready and the organizer’s setup was published.
Writing a workflowImprovedArea: CLIFind the command you need
Command-line help now opens with a one-screen overview, with focused pages for each group of commands and each command. Search help by task to find the right commands and guides, or open the full reference when you want every option.
FixedArea: FilesRetry a document edit without making it twice
If the reply to a command-line document edit is lost, repeating the same edit with its original request ID returns the first result, even if the document has changed since. Reusing that ID for different text or a different document is refused, so an old receipt can’t stand in for a new edit.
Recovering a lost replyFixedArea: CLIScripts get one complete JSON result
Commands run with JSON output now return one complete result, even when a later step fails. If a wait times out, the result keeps the last status it saw and says the work isn’t finished, so your script won’t mistake a timeout for success or have to parse two replies.
ImprovedArea: FilesKeep your filters in sight
The Files list now keeps filters, sorting, and layout controls together, with your active filters visible and easy to clear. Expand a file’s details when you need more room. Details that are still loading say so, so a slow response no longer looks like a file with no tags.
ImprovedArea: FilesEdit the part of your naming rules you meant to change
Edit each section of your file naming rules directly: the naming pattern, the organizing goal, and the grouping terms. Changes save to your draft, so you can review them and choose when to start using them. The setup now focuses on Regions, File types, and Work status; the separate Themes section is gone.
ImprovedArea: ExtractionExtraction checks follow your Shape’s definitions
When a Shape spells out what belongs in a type, what doesn’t, and what to do when a source has no example, extraction now uses those definitions to check proposed findings. Types without them are checked as before.
Creating a ShapeNewArea: DocsFind the guide for what you’re trying to do
Penumbra now has public docs that connect product concepts with practical guides, troubleshooting, and an API reference. Follow a task from bringing in source material to reviewing findings or publishing a Brain.
How Penumbra fits togetherFixedArea: CanvasOpen a file’s tags from your canvas
Edit tags now opens the tag editor directly from a file on your canvas. It shows the file’s current tags, ready for you to change, without asking you to run the automatic organizer first.
ImprovedArea: CanvasFind your next canvas card sooner
Search shows matches as they arrive, so you can choose a file while the rest are still loading. Narrow by type, move through results with your keyboard, and keep your selection as more details appear. If part of a search fails, the results already found stay available.
NewArea: BrainsGive your knowledge a page of its own
Publish a Brain as a page people can open in their browser. Add a title and introduction, choose anyone with the link or a list of people, and decide whether to offer original file downloads. Readers get the content you selected, with file previews built in.
Publishing a BrainNewArea: WorkflowsRun a workflow from your terminal
Start a published workflow, follow its progress, and inspect the result from the command line. If your connection drops, return to the same run to see where it stands. Retrying the same start request recovers that run instead of starting the work twice.
WorkflowsNewArea: FilesBring a web page into your project
Save public web pages into a collection from the command line. Each page becomes a file with searchable text, a visual preview, and its original address, ready to use alongside your other documents.
Bringing in web pagesImprovedArea: FilesSee what your synced folder needs
A synced folder’s page now puts its status and actions at the top: open its files, reconnect, sync, pause, or stop. Files that weren’t brought in are listed next to those that were. Folders on your computer show when they last synced and the command that brings in newer changes.
Synced foldersImprovedArea: FilesSee what a web import will bring in
Before importing a website from the command line, preview which pages will be kept, which will be left out, and the estimated cost. Duplicate addresses and links that aren’t web pages are left out. The preview adds nothing to your project.
Importing web pagesImprovedArea: ShapesA clearer way to work on a Shape
Open a type or relationship with one click anywhere on its row, or with Enter or Space. Both lists stay open together, and relationship details use the names in your Shape, so you can follow the model without translating it as you go.
Changing a ShapeNewArea: CLIPenumbra on Linux
The Penumbra command line now runs on Linux, on both Intel and ARM machines. It installs as a single executable, with no Node.js setup required, so you can use Penumbra from your workstation or a remote machine.
ImprovedArea: GraphMake more room for the connections
Load more records into the graph and keep exploring. Counts now reflect what you can actually see, connections stay with their records as the graph grows, and labels make better use of the space as you zoom.
NewArea: CLIPenumbra on Windows
Install the Penumbra command line directly from PowerShell on Windows x64. Sign in through your browser, work with your projects and files, and update the installed command in place. There’s no Node.js or Linux environment to set up.
NewArea: ShapesBuild a Shape from the material you already have
Give Shape generation reference files or a collection from your project, alongside your brief. The command line accepts references by name, so a report, interview set, or working document can help define the knowledge you want to capture.
Creating a ShapeImprovedArea: GraphBetter matches for the question you’re asking
Search across your records with a question or phrase and get a more relevant ordering of results. Penumbra now considers how well each candidate answers the query, while exact keyword search keeps its familiar ordering.
Searching your projectImprovedArea: ShapesStarter Shapes leave room for incomplete evidence
The starter library is better at capturing useful findings even when a source leaves something unsaid. Research, market intelligence, AI planning, and other Shapes now distinguish missing optional detail from a reason to discard the whole finding.
ImprovedArea: ExtractionValid isn’t the same as reviewed
Command-line validation now keeps two questions apart: whether findings follow the Shape’s rules, and whether their review flags are resolved. It shows how many findings still need attention and how to inspect them, so passing validation no longer looks like those questions are settled.
Reviewing findingsFixedArea: ShapesA draft worth fixing is worth keeping
A generated or refined Shape that needs corrections now stays available as a draft, with the problems called out. You can work from what was produced instead of losing the draft and starting again.
Changing a ShapeImprovedArea: CLIA useful starting point in your terminal
Run penumbra on its own to see where you are and what to do next. The welcome screen shows your selected project, or a short list of projects with the commands to choose one. Help is still there when you need the full reference.
FixedArea: ShapesKeep the question after the decision is made
The Decision Log Shape now captures a decision question whether it is still open or has already been answered. Link it to the decision that resolved it, so the reasoning includes the question as well as the conclusion.
FixedArea: ExtractionAn empty optional field no longer costs you a finding
Extraction no longer throws out an otherwise valid finding because an optional field came back empty in a form the Shape doesn’t accept. It drops that value and checks the rest. Required information is still required, and missing facts aren’t made up to let a finding pass.
Extracting from filesFixedArea: AccountChoose another password without starting over
If a new password doesn’t meet the requirements, Penumbra now says why and lets you try another. You no longer have to request a fresh reset link because your first choice was refused.
ImprovedArea: FilesFind the file, or go straight to the passage
Command-line and agent search can return whole files as well as individual passages. Short summaries help you decide which file to open, while passage matches point you toward the relevant page or section. Narrow the search to a collection when you already know where to look.
Searching your projectNewArea: FilesSay what you’re adding
Use the microphone in Add Files to dictate a note for an upload. Capture the context while it’s fresh, then use the resulting text as the note attached to that batch.
Voice notesNewArea: FilesGive a batch of files a little context
Add a note to a group of files as you upload them. The organizer can use that shared context when proposing tags, so you can explain what the files belong to once instead of repeating it for each one.
FixedArea: FilesThe later pages deserve a look, too
Long documents no longer lose their page images partway through because of the previous preview-size limit. Newly processed files can keep those later pages available for visual search, and existing pages without images no longer get pushed down the results for that reason.
ImprovedArea: ShapesApprove a library Shape’s renames before they arrive
When a linked library Shape renames a type, property, or relationship, that update now waits for you to accept it. Updates that only add things still follow your automatic-update setting. Views keep finding records across a rename, including records saved under the old name.
Changing a ShapeNewArea: FilesSee the passage behind a citation
Open a citation in a PDF or slide deck and see the quoted passage highlighted on the page. When Penumbra can’t confidently locate the quote, it leaves the page unmarked. Older files may need to be reprocessed before their citations can highlight.
Passages and citationsImprovedArea: FilesSearch what a chart or screenshot shows
Search can now find relevant rendered pages in PDFs, presentations, and Word documents using what’s visible on the page as well as its text. That gives diagrams, charts, and screenshots another way to surface when their meaning isn’t captured by a caption.
Searching your projectImprovedArea: FilesBetter reading for scans and tables
Scanned PDF pages get a more careful reading of their text and numbers. Table rows that wrap onto another line are kept together more reliably, so the extracted text is easier to work with. These improvements apply when a file is added, replaced, or reprocessed.
Checking file textImprovedArea: CanvasCheck the source without leaving your canvas
Open a file or record on top of your canvas, then close it to return to the same spot on the board. Double-click a card or press Enter to open it. Previews show the exact version the card refers to.
NewArea: CanvasUndo and redo on the canvas
Undo and redo adding, removing, and moving cards, including changes to several cards at once. Panning and zooming aren’t part of the history, so getting back to an earlier layout doesn’t mean retracing every look around the board.
ImprovedArea: ExtractionOne review, one approval
Findings waiting for approval now open in one review with a single Approve changes button. You no longer approve the request and then submit the same work again. An older approval link takes you to the newest request when there is one.
Reviewing and submittingFixedArea: ExtractionPick up an interrupted review
An interrupted submission can resume from the work you already approved. You don’t have to repeat the review, and retrying the submission won’t save the same findings twice.
Reviewing findingsNewArea: FilesGive a file a clear title and keep its name
Give a file a readable title without changing its filename or location. This works for files in a synced folder too: the original name and links stay the same, and search finds the file by its new title.
Files and titlesNewArea: ExtractionBring back a review you set aside
Restore a discarded review with its proposed findings intact. Penumbra checks them against anything that changed while the review was closed and flags items that need another look. Restoring doesn’t submit the review or overwrite newer work.
Workspaces and review recoveryFixedArea: FilesMore room for your files
The Files list now uses the available height of the page. You can see more of your library at once instead of scrolling through a short panel with empty space underneath.
NewArea: FilesWrite with an agent in Wordcraft
Wordcraft is now available through Penumbra Labs. The open-source editor lets you and an agent contribute to the same Markdown document, save it to your project, and reopen it later. If a connection drops during a save, your draft stays available to retry.
ImprovedArea: FilesRead the pictures inside Word documents
Text inside pictures in a Word document now joins the surrounding paragraphs in the extracted content. Screenshots and embedded diagrams can contribute to search and analysis, instead of disappearing between the text. Small decorative images are left out.
Checking file textFixedArea: FilesFewer unrelated search results
Search is more willing to say it didn’t find a useful match. Loosely related results are filtered out, while exact-word matches still have a way through. If nothing fits, you can try a more specific phrase instead of sorting through a page of near misses.
Searching your projectNewArea: FilesTurn new source material into a running account
A maintained document can build a running log of observations from source material, then use that log to update a focused working document. Citations connect the written account back to its sources, so you can follow how a conclusion developed.
ImprovedArea: FilesReview an agent’s edit before it becomes the document
Connected agents can propose changes to a native document and wait for your approval. Review the replacement text, approve it, and keep working from the saved version. Reopening the approval returns the same result rather than applying the edit again.
Editing documentsNewArea: FilesBring your Granola notes into the project
Connect a Granola folder to bring meeting notes and transcripts into Penumbra as searchable files. Scheduled sync picks up the source again without duplicating unchanged notes. Disconnecting the source leaves the files already imported in your project.
Synced folders and notesNewArea: ShapesFind a Shape you can make your own
Browse the Shape Marketplace, preview what a Shape contains, and add it to your project. Start with a published model or customize an editable copy. Linked Shapes have an update preference, so you can choose whether to follow changes from their publisher.
Shapes and the libraryNewArea: GraphAn assistant that works with your records
Ask the project assistant about the records and relationships in your knowledge graph. It can also propose changes for you to review and approve before they are saved, keeping the conversation connected to the work in your project.
NewArea: GraphBuild with the names in your Shape
Your Shape can become a typed interface for working with its records and relationships in TypeScript. Build queries using the concepts you defined, with generated types that help you see which properties and connections are available.
Working with typed recordsNewArea: CanvasA canvas for thinking with your knowledge
Bring files and records onto a canvas and arrange them around the question you’re working on. Keep useful material together in a spatial view you can return to as your thinking develops.
ImprovedArea: FilesKeep the date that belongs to the source
Give a file its original source date, even when you added it to Penumbra much later. The file editor keeps that date separate from its arrival in your project, and record details make source and due dates easier to inspect.
ImprovedArea: GraphFollow a connection back to its source
An extracted relationship can carry its own source passage, just like a record. See where a connection came from and read the supporting quote alongside the records it joins.
Passages and citationsImprovedArea: ExtractionSee the cost before extraction starts
Extraction estimates the cost of a run before the work begins. You can weigh the files and effort you’ve selected against the estimate, rather than starting without a sense of the spend.
Extracting from filesNewArea: FilesSee what was learned from a file
Trace a file version to the records and relationships that cite it, including findings still waiting in a review. Connected tools can follow that trail from the source to the knowledge built from it.
Following sourcesNewArea: AccountSend feedback from where you’re working
Send feedback from the App and attach a screenshot when it helps explain the problem. Preview, replace, or remove the image before sending. You can also submit feedback from the command line or through a connected assistant.
Sending feedbackImprovedArea: ExtractionChoose how much work to put into extraction
Choose Fast or Standard extraction for the files and knowledge you’re working with. Stop a run when you need to, then resume completed portions without starting everything again. Findings and proposed connections still arrive for review before they enter your graph.
Extracting from filesNewArea: BrainsShare a focused slice of your knowledge
A Brain gives a selected part of your project a home of its own. Choose the content, decide which tools an agent can use with it, and manage access without handing over the whole project. Its activity view helps you see how that knowledge is being used.
BrainsNewArea: FilesRead PDFs without leaving your project
Open a PDF in Penumbra with page thumbnails, zoom controls, and page navigation. Move through the original document while keeping it close to the rest of your work.
ImprovedArea: ExtractionReview findings without losing your place
Work through extracted findings in a focused review queue. Edit a finding where you see it, remove one with an option to undo, and add or connect records as you go. After confirming a review, move on to the next item.
Reviewing findingsImprovedArea: ShapesSee how your Shapes fit together
Browse published Shapes and drafts in one library, then look across their types and relationships. Search, filter, and sort the lists to find a concept or inspect its properties without opening every Shape in turn.
Shapes and the libraryImprovedArea: CLISign in to the CLI through your browser
Start a command-line login, finish signing in in your browser, and return to your terminal ready to work. Your browser session completes the connection without a manual key-copying step.
NewArea: AccountShare the part of a project someone actually needs
Create a View that selects files, collections, Shapes, or types of records. Limit a client, connected agent, or read-only key to that View, and inspect what it has read from the Access page. The rest of your project stays outside that connection’s view.
Views and accessNewArea: ShapesStart a Shape with a brief
Describe the knowledge you want to organize and generate a first draft of a Shape. Review its types, properties, and relationships, then refine the draft before publishing it for use in your project.
Creating a ShapeNewArea: FilesSee Word documents and slides as pages
Word documents and PowerPoint presentations now get rendered page previews and recognizable covers. Browse the document’s layout alongside its extracted text, including files whose useful content lives in a header, footer, or image.
NewArea: FilesTeach the organizer your naming rules
Describe how your team names and groups files, then turn that guidance into an organizer setup. Review the draft, refine one part, or edit it directly before publishing. Writing the rules doesn’t rename your files; proposed changes still come separately.
NewArea: AccountKnow when your work is ready
The notification bell brings completed work and problems back to your attention. See when findings are ready for review, when a run found nothing new, or when something failed, with a clear distinction between each outcome.
NewArea: AccountGive each agent the tools it needs
Choose a set of Penumbra tools and save it as a Kit for a connected agent. Keep each connection focused on the work it should do, and review changes that require your approval before they take effect.
Agent KitsNewArea: AccountSign in with Google
Use your Google account to sign in to Penumbra and reach your organizations. One less password between you and your work.
NewArea: ExtractionTurn files into findings you can review
Use a Shape to draw records and relationships from your files. Findings keep the source passages that support them and arrive in a review workspace, so you can inspect what was found before adding it to your knowledge graph.
Extracting from filesPut your knowledge to work.
Start a project
